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I. INTRODUCTION 


A. CACHE MEMORIES 

Cache memories are usually small memories that contain blocks of data and/or 
instructions [Ref. 1]. Each block is a copy of consecutive data and/or instruction bytes 
from main memory. Caches are usually much faster than their main memory counter parts. 
They are, in effect, short term memory. The cache contains a set of blocks recently 
accessed by the CPU. The cache can provide the most recently used data and/or 
instructions to the CPU in less time than it would have taken to get the information from 
main memory. However, if the cache fails to provide the information, then it fetches the 
information from main memory and, depending on its design, may choose to enter the 
information into the cache. The cache also performs memory updates in the form of writes. 
Memory updates can occur when the CPU makes a write request, or the cache can store 
new data in the cache blocks and wait until later to write the data to memory [Ref. 2:p. 197 
]. A dirty block is a cache block which contains data that is more current than memory 
because of a recent write request. 

The concept of the cache storing recently used memory blocks is very simple. In 
fact, many early cache designs were simple implementations of the concept. However, the 
task of building an optimized cache is not trivial. The difficulty comes from trying to 


provide the CPU with the correct data or instruction as soon as it 1s available. For example, 


ifa block read is in progress and there is enough data available to satisfy the pending load, 
the data should be forwarded to the CPU rather than waiting for the block read and cache 
update. The cache often performs block management between reguests. One example of 
block management is writing dirty data to memory. Another example is reading data that 
was not part of the CPU reguest, but located in the same block. This allows the cache to 
contain all the data that was in the block. An optimized cache performs block management 
only after completing the CPU request. Complications arise when the CPU makes another 
request before the block management for the last request is complete. If this happens, the 
cache has to search for data in the control sections of the cache as well as the cache 
memory. 

More and more cache designs incorporate read and write buffers in their control 
sections. These buffers allow the cache to perform block management while minimizing 
the effect on the CPU request [Ref. 3]. For example, if a CPU read request results in a 
miss and the block victim has a dirty sub block, then writing the dirty sub block to memory 
may occur after reading the replacement block. This allows the cache to forward the read 
data to the CPU before writing the old data to memory. Figure | provides a simplified data 
flow diagram that illustrates buffer use in modem cache designs. 

Scoreboarding is a term that has been used to describe the process of searching, and 
choosing the correct value of a register argument. Scoreboarding in a cache represents the 
act of searching and altering buffers based on new CPU requests. One example of 


scoreboarding is searching a buffer for CPU requested data. Searching block and write 


Read & Write 


Requests 
4 Cache 


CPU Read &Write = ` Memory 
Data 


| Assembly 


Block Buffer 
Read Buffer 
Write Buffer 


Main Memory 


Figure 1 Typical Cache Data Flow Design 





buffers may provide data that is not available in the cache memory. Searching the read 
buffer ensures that no duplicate read requests are placed in the buffer. However, it will not 
provide any new data. Another example of scoreboarding is updating read requests in the 
read buffer with data provided by CPU write requests. 
B. PROBLEMS OF CACHE MEMORIES 

Cache memories can cause more problems than they solve and they can 
significantly complicate the memory model. The most obvious problem with a cache 
memory is that it does not always contain the data that the CPU requests. This is defined 
as a read miss. A write miss is when the CPU makes a write request and the correct block 
is not in the cache. Conversely, a read hit is when the data is available, and a write hit is 


when the block is available. There are three types of cache misses [Ref. 4:p. 419]. First, 


the compulsory miss results when data is accessed for the first time. Second, the capacity 
miss, occurs when the cache is not big enough to carry all the blocks reguired. The third 
type, collision misses, occurs when the cache requires several main memory blocks that 
map to the same set of cache blocks. This causes a form of thrashing similar to that seen in 
virtual memories. 

In some numerical calculations, the cache makes the average access time greater 
than the main memory access and transfer times. This is often due to matrix operations that 
access elements across rows and force the cache to enter an entire block of data for each 
element read Depending on the size of the matrix, it may not be possible to save enough 
blocks to ensure that the next block accessed was not selected as a victim and replaced. As 
a result, many architectures support special load and store instructions that bypass the 
cache. 

C EXISTING CACHE SIMULATORS 

There are a number of cache simulators. Two examples include Dinero HI, and 
Tyco [Ref. 5]. Dinero III provides hit and miss data for a wide range of input arguments. 
Dinero IH will also simulate either a unified cache, or separate data and instruction caches. 
Tyco, on the other hand, simulates several different cache options simultaneously for 
comparison. 

D. PROBLEMS WITH EXISTING CACHE SIMULATORS 

Unfortunately, both Dinero III and Tyco limit their simulations to hit-miss 


calculations. With nothing but hit-miss information, the designer cannot optimize his cache 


for the lowest average access time. Most caches are designed to have low average access 
times rather than high hit rates [Ref. 4:p. 405]. Since Dinero III and Tyco do not perform 
any timing analysis, they may mislead the designer. Dinero III and Tyco also do not 
provide any buffer simulations because they assume that the cache has all the time it needs 
between loads and stores to complete all of its block management. Since buffer 
management and scoreboarding have such a large effect on the average access time, there 
is an obvious need for a simulator that can perform accurate timing analysis, buffer 


management, and scoreboarding. 


Il. INTRODUCTION TO SACS 


A. THE NEED FOR STILL ANOTHER CACHE SIMULATOR 

A cache simulator should not only simulate the cache memory, it should simulate 
main memory and any buffers it uses. As discussed earlier, neither Dinero III nor Tyco 
provide any means for simulating buffers or memory. 

Without timing analysis, the designer is unable to determine the effect of 
scoreboarding protocols. These protocols, which are usually very difficult to implement, 
can be avoided by delaying any read requests until all writes are completed and the last 
read block has been entered into the cache. Timing analysis allows the designer to choose 
the scoreboarding technique that best suites his or her resources and architectural 
requirements. A hit-miss cache simulator reduces this process to guess work. 

B. COMPARING SACS TO OTHER CACHE SIMULATORS 

As previously discussed, other cache simulators provide hit-miss results, while 
SACS provides the all important average access time. However, in addition to the correct 
performance measurements, a simulator should illustrate a cache's strengths and 
weaknesses. It should give the user a clear understanding of how to improve the cache's 
design. With Dinero III, the user could only guess on how to improve his/her cache design. 
Tyco attempted to correct this problem by allowing the user to simulate several caches 


simultaneously. However, given the number of different variables and policy choices, 


exhausting all possible combinations is not the best way to design a cache. SACS is unigue 
because it provides the user with a detailed analysis of exactly what the cache was doing 
during a simulation run. The user can then identify and correct specific problems with a 
cache design. 
6. THE CAPABILITIES OF SACS 

SACS allows the designer to experiment with different policies while measuring 
their affect on the average access time. SACS provides the user with more detailed 
information because it maintains a log of how every clock cycle is spent. This log is kept in 
the form of a histogram. It allows the user to see exactly how much time is spent 
performing read or write requests. It also records how many times a request was 
completed within a given time period. With these details, the user can easily evaluate the 
cache's performance. A second histogram is available which details the amount of time 
spent performing cache accesses, memory accesses, and waiting for full buffers. With this 
histogram, the designer can target specific weaknesses. It also provides a good comparison 


of the effect of different scoreboarding policies between runs. 


I. SACS INPUT PARAMETERS 


INTRODUCTION 


SACS provides a wide range of input parameters to model various different 


functionally diverse caches. While it is impossible to imagine what kinds of caches 


designers might build in the future, every effort was made to allow the designer to simulate, 


or most nearly approximate, his or her design. Table | lists arguments that SACS 


supports. 


TABLE 1. 


SACS INPUT ARGUMENTS 


Cache Size (-cs n) 

Blocks Size (-bs n) 

Sub Block Size (-sbs n) 
Associativity (-a n) 

Word Size (-ws n) 

Read Cache Access Time (-rcat n) 
Read Cache Hit Time (-rcht n) 
Read Cache Miss Time (-rcnit n) 
Write Cache Access Time (-wcat n) 
Write Cache Hit Time (-wcht n) 
Write Cache Miss Time (-wcnit n) 
Memory Access Time (-mat n) 
Memory Transfer Time (-nitt n) 
Buffer Cache Access Time (-bcat n) 
Read Buffer Size (-rbs n) 

Write Buffer Size (-wbs n) 

Block Replacement Policy (-brp el) 
Write Policy (-wp e2) 

Write Miss Policy (-wmp e3) 





n 


el 
v2 
eð 


Read Forward (-rf -drf) 

CPU Waits For Cache Writes (-cwfew -dcwfcw) 
Search Block Buffer (-sbb, -dsbb) 

Update Read Buffer (-urb, -durb) 

Remove Read Duplicates (-rrd, -drrd) 
Remove Write Duplicates (-rwd, -drwd) 
Read Priority (-rpr n) 

Write Priority (-wpr n) 

Read For Write Allocate Priority (-rfwapr n) 
Write Dirty Block Priority (-wdbpr n) 

No Priority (-npr n) 

Trace (-t, -dt) 

Check (-c, -dc) 

Test (-test) 

Kev Board IO (-kbio, -fio) 

Data File Name (-f "File Name") 

Screen Histogram Max Index (-shnu n) 

File Histogram Max Index (-fhni n) 


Unsigned Integer 


" enumeraton type (LRU. FIFO. RAND) 


enumeration type {Wnte Through. Wnte Bach} 
enumeration type {Wnte Around, Wnte Allocate} 


8 


B. SIZE ARGUMENTS 

All sizes are entered in bytes. Cache Size must be an even multiple of both Block 
Size and Associativity. Block size must be an even multiple of Sub Block Size, and Sub 
Block Size must be an even multiple of Word Size. Word Size may be any positive integer 
that does not force an integer overflow in Cache Size or Block Size. 
€. CACHE ACCESS, HIT, AND MISS ARGUMENTS 

Cache Access Times represent the time required for a request to access the cache, 
providing the cache is not busy. At the end of this time it is determined whether the request 
is a hit or a miss. The Cache Hit Time represents the time required to complete a request 
once the cache access time has expired and the request has been identified as a hit. If the 
request was a miss, then the Cache Miss Time 1s used instead. 
D. MEMORY ACCESS AND TRANSFER TIME ARGUMENTS 

The Memory Access Time 1s the time required for a buffer to access, and then 
transfer, the first word of a request from memory. Memory Transfer Time is the time 
required for a buffer to transfer each consecutive word following the first access. 
p. BUFFER ARGUMENTS 

After a memory read, the Block Buffer contains the new data that must be entered 
into the cache. The time that the Block Buffer takes to access the cache is called the Buffer 
Cache Access Time. The Block Buffer may have to wait longer because the cache 1s busy. 
The buffer cache access will not occur if a read or write cache access is required during the 


same clock cycle. However, once the access begins, the read and write cache accesses are 


locked out until the cache is updated. The Read and Write Buffer sizes can be any positive 
non zero integer (<100). 
F. CACHE POLICY ARGUMENTS 

Block replacement policy determines the method used to choose the location of a 
new block in the cache. SACS supports three block replacement policies: Least Recently 
Used (LRU), First In First Out (F7FO), and Random (RAND). There are two write 
policies: Write Through, and Write Back. The Write Through policy forwards the data to 
memory immediately after a write request. However, in the Write Back policy, the data is 
saved in the cache until the block that contained the data is selected as a victim. Dirty bits 
indicate which sub blocks have new data that must be written to main memory. 

SACS can easily be modified to support new write, or write miss policies by adding 
the new policy name to Write Policy Types, or the Write Miss Policy Types in SACS.h. 

The code to simulate these new policies must be placed in the procedures Write Hit, and/or 
Write Miss which are both located in Cache.c. New block replacement policies may also 
be added by modifying Replacement Policy Types in SACS.h, and Select Block Victim in 
Cache.c. 

If CPU Waits For Cache Writes is asserted the CPU will wait after a write request 
until the cache is complete with the write. Otherwise, it is assumed that the cache can carry 
out the write while the CPU continues with other instructions. 

If Read Forward is asserted, then a read miss is complete once the data required 


arrives in the block buffer. Otherwise, the read must wait until the block updates the cache. 


G. SEARCH BUFFERS AND UPDATE BUFFER ARGUMENTS 

Search Block Buffer allows the cache to search the block buffer in case the read 
data was already received from memory. If any part of the data 1s found in the buffer, then 
the size of the request will be appropriately reduced Update Read Buffer allows a write 
memory request to provide data required by a read request. If any read request needs the 
data provided by the write memory request, then the size of the read request will be 
reduced appropriately, and the data is not read from memory. 
H. REMOVE READ DUPLICATES AND WRITE DUPLICATES 

ARGUMENTS 

Removing read and write duplicates means that requests that have intersecting or 
concurrent data will get spliced together into one request. Otherwise, a buffer may contain 
multiple requests to the same memory location. 
I. PRIORITY ARGUMENTS 

In SACS, the user specifies the priority of requests. The lowest numbers represent 
the highest priority. This allows the designer to simulate a cache that must finish all writes 
before starting a read. It also allows the designer to delay reads for write allocated blocks, 
and the writing of dirty blocks. 
J. SACS CONTROL ARGUMENTS 

it Introduction 

SACS has control arguments that allow the user to select one of several 


modes of operation. 


Za Trace Argument 
The trace mode permits the user to step through a trace, one clock cycle at a 
time, viewing the contents of the cache and buffers, and obtain statistical results. 
a Check Argument 
When SACS is in the check mode, it performs a self check of all of its 
global variables. These checks include checking to see that all the global variables that 
should remain constant, do in fact remain constant. Global variables that are not constant 
are checked to see that they are within prescribed bounds. This form of checking can occur 
while the program is in any other mode (1.e., Trace, Test, or Key Board I/O). This check 
can be performed during normal data runs. This kind of checking helps to identify errors 
that might have gone unnoticed. It also assures the user that the program did not 
catastrophically fail during a run. 
4. Test Argument 
When SACS is in its test mode it can do nothing else. It will automatically 
generate its own input data. The data is generated by randomly selecting a finite number of 
test cases to use. Each test case has a combination of seven load/store instructions. The 
expected number of read and write hits for each test case is known. Therefore, the total 
number of read and write hits for the trace can be determined. The actual addresses used 
for each test case are chosen randomly. However, all the loads for a particular test case 
will map to the same block. Similarly, all stores will also map to the same block. SACS 


wil! randomly select its own set of input parameters, ignoring any other arguments entered. 


It will then run the main routine on the test trace as if it was a user defined file. Once the 
trace is complete, SACS will compare the results with what it expected from the random 
trace. If no errors have been detected, then SACS will repeat the process of randomly 
generating its input file and input parameters. The test mode places SACS into an infinite 
testing loop. The only way to terminate the process is to kill the process. The decision not 
to give the user a more graceful way out of the test mode was made because C does not 
provide a way to trap IO. While there are operating system methods of trapping IO, they 
would have made the program system dependent and, therefore, non-portable. The current 
version of SACS has been compiled and run on both a PC running DOS and a SPARC 
station running Sun -OS without any changes to the source code. 
5. Key Board IO Argument 
SACS normally accepts its inputs from a data file. However, it can accept 
inputs directly from the user. This input mode can be used with the trace and checking 
modes if desired. SACS will ask for each request from the terminal as required. The trace 
display will appear each time a new request is made. However, it will not stop every clock 
cycle unless the user selects the trace mode. 
6. Data File Name Argument 
SACS normally assumes that the data file is named "SACS.Dat”, however 
the user can specify the name of the file he or she wishes to trace using the data file name 


argument. 
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d Histogram Max. Index Arguments 

SACS provides the user with two timing histograms. One provides timing 
analysis for read and write requests. The first histogram illustrates how many requests 
were completed during the designated time. The second histogram provides timing 
analysis for the number of times the cache waited to complete a particular task in the 
designated time. The maximum index for these histograms is the maximum number of 
time bins. Since there may be data out of the maximum index range, the last bin is used to 
total all events with times greater than or equal to the maximum index. The screen 
histogram maximum index is the number used for screen displays. The screen maximum 
histogram index has a default value of 4, which allows all displays to fit on a standard 80 
column screen. However, if a Unix window is available, the designer may want to raise 
this number to get more detailed displays. The file histogram maximum index is used for 
the output file generated by SACS. This file may have a much larger range because it does 
not have to be printed on a screen. The output file is compatible with MATLAB script 
files. This allows results to be read and processed by MATLAB for statistical analysis and 


plotting purposes. 


IV. SACS DISPLAYS 


A. TRACE DISPLAY 
I. Introduction 
SACS includes a trace mode that allows users to monitor the behavior of the 
simulated cache and the implemented policies and scoreboarding technigues. The user 
may also need to debug any modifications made to SACS. The trace mode is also very 
useful in identifying any programming errors. The trace mode allows the designer to 
review the status of the cache at the end of each clock cycle. A trace display is shown in 


Figure 2. 


Current Reguest: Read Time: 

Address: 2AF769F9 Next Request Time: 
Size: 07 TOA: 

Cache Waiting For: Read Memory Request 

Memory Waiting For: Memory Read Access Cache Hit: 

Block Waiting For: Memory Block Transfer Buffer Hit: 


Set Block Address V/D V/D / V/D 
00031 00124 25E379F0 0 0 
00125 2AF769F0 0 0 
00126 00000000 0 0 
0 0 


00127 00000000 


Read Buffer Address Size i Block Priority Comp. Time 
2AF769F9 16 07 00125 00 53 


Write Buffer Address Size Reg. Block Priority Comp. Time 
25E37A10 10 00 00000 11 58 


Block Buffer Address Size Reg. Block Priority Comp. Time 
2AF769F8 00 00 00125 00 D3 


Next Command Please [ T, R, S, C, G 4, 8, -8, Help) >>> 


Figure 2 Trace Display 
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2. Current Request Fields 
The trace display contains the last CPU request, as well as the request 
address and size. SACS can only process requests that are contained within the same 
block. If a request spans across two or more blocks, then the request is split up into block 
size requests and processed separately. 
3. Cache Waiting For Field 
Whatever is holding up the last CPU reguest is shown in the Cache Waiting 
For field. In Table 2, we can see all the things that the cache might have to wait for. If the 
cache is waiting for nothing, then the reguest has been satisfied. If the cache is waiting for 
a read or write cache request, then the cache is being accessed. If the cache is waiting for a 
memory request, then some part of the request must be retrieved from memory and the 
data is not available. If the request can not proceed because one of the buffers is full, then 
Cache Waiting For will indicate whether the request is waiting for the full read buffer or 
the full write buffer. Note that a read miss request may have to wait for dirty blocks to be 
written to memory, making it possible for a read request to wait on a full write buffer. 
4. Memory Waiting For Field 
Memory Waiting For identifies which memory function is in progress. 
When a new memory access begins, Memory Waiting For indicates whether it is a memory 
read request or a memory write request. Once the access of the first word is in progress, 
then Memory Waiting For will indicate either read access or write access. However, once 


the first word has been received, then Memory Waiting For will switch to indicate either a 


read transfer or a write transfer. If a memory read reguest needs to begin and the block 
buffer is busy because it has not updated the cache from the last reguest, then Memory 
Waiting For will indicate cache update. 
a. Block Waiting For Field 

Block Waiting For describes what the block buffer is doing. It will indicate 
memory block transfer when a memory read access or transfer is in progress. However, 
once the transfer is complete, the block buffer must update the cache. If the cache is busy, 
then Block Waiting For will indicate that it's waiting for cache access. When the cache is 
not busy and the cache update begins, then Block Waiting For will switch to indicate block 


cache transfer. 


TABLE 2. 
WAIT FOR CONDITIONS 


Cache Memory Block Buffer 
Wait For Conditions Wait For Conditions Wait For Conditions 


Nothing Nothing Nothing 
Read Cache Request Memory Read Request Memory Block Transfer 


Read Memory Request Memory Read Transfer Block Cache Access 
Write Cache Request Memory Write Request Block Cache Transfer 
Write Memory Request Memory Write Access 
Full Read Buffer Memory Write Transfer 
Full Write Buffer Cache Update 
CPU Cache Access 





6. Timing Data Fields 
The trace display shown in Figure 2 includes a time field that indicates how 


many clock cycles have passed since the start of the run. The Next Request Time 1s the 


17 


time at which the CPU either has, or will make, another reguest. The TOA field indicates 
when the next memory word will arrive into the Block Buffer. However, if a write was in 
progress, this field would be a TOD field, and would indicate the time that the next word 
will leave the Write Buffer. 
di Cache Hit and Buffer Hit Fields 
The cache hit field indicates whether a request Is a hit or not. The buffer hit 
for a read request indicates whether the data requested is in the Block Buffer. A buffer hit 
for a write request indicates that the Write Buffer needed to write the data to memory 
anyway. A buffer hit will only occur during a cache miss. Buffer hits allow the designer to 
determine how many times the scoreboarding was used during a run to avoid a memory 
access. However, the true measurement of a cache's performance is its average access 
time. 
8. Address Block Selection Display 
During a trace run it is helpful to see the cache set that the request address 
got mapped to. This includes all the blocks that the cache had to work with to satisfy the 
request. If the request is a hit, the block that it hit on has to be in this set. If a block victim 
is chosen, it has to be chosen from this set. 
9. Buffer Displays 
The contents of all the buffers are displayed so that the designer may see 
what the memory is working on. The Request Size is the number of bytes that have to be 


read in order for the current request to have all the data originally asked for. This number 


might be reduced from the original reguest size if part of the data is in the cache or if Block 
Buffer is allowed to contribute data to the reguest. During the trace, the address, size, and 
reguest size will constantly change as CPU reguests, and memory accesses and transfers, 
are made. The block field indicates which cache block the read data will be placed in. The 
priority field indicates the priority of the memory reguest. A zero priority indicates that the 
request is in progress. The next lowest number will be serviced next, unless a new 
memory request is made. If more than one request has the same priority number, then the 
read buffer will take priority. If the read buffer has more than one request with the same 
priority, then the priority will switch to FIFO. 
10. Time Required and Completion Time Fields 
Every memory request has a Time Required to complete and a Completion 
Time. The Time Required to complete is the time that memory will have to service the 
request. The Completion Time is the time that the request is expected to be removed from 
the buffer. 
11. Next Command Please 
The next command line includes a prompt for the user of all the available 
commands. Shown in Table 3 is a list of all the commands. In the following paragraphs, 


these commands are discussed in detail. 


TABLE 3. 
TRACE COMMANDS 


Trace Display (T) 
Results Display (R) 

Stall Timing Display (S) 
Cache Arguments Display (C) 
Go To A Specific Time (G ff) 
Increment Time (#) 
Decrement Time (-#) 


Help (H) 














B. RESULTS DISPLAY 

The Results Display, shown in Figure 2, provides the user with the number of 
requests, cache hits, and buffer hits. The hit rates are a combination of both the cache hits 
and the buffer hits. The Request Time Histogram gives the number of requests that were 
completed in the prescribed time. The total amount of time spent on each request, and the 
average access times, are also displayed. As discussed previously, the average access time 


IS the ultimate measure of cache performance. 








Reguests Break Down 


Number Number 
of of 
Cache Hits Buffer Hits 


T T 
4 0 
5 1 


Request Time Histogram. 


Ave 
Access 
Time=00 Time=01 Time=02 Time=03  Time>=04 Total Time 
Read 0 2 0 0 2 11 2.750000 
Write 3 4 0 0 0 4 0.571429 
Idle 0 21 0 0 0 21 


Next Command Please [ T, R, S, C, G #, #, -#, Help] >>50 


Figure 3 Results Display 


C. STALL DISPLAY 

The stall display provides the designer with an exact account of where the cache 
spent all its time. As shown in Figure 4, the stall time histogram lists all the events that the 
cache has ever waited for, and the number of times that the cache waited for an event 


within a designated period. 


Stall Time Histogram 

Time=00 Tame=01 Time=02 Time>=03 Total 
Nothing 2 
Read Cache Request 
Write Cache Request 
Read Memory Request 
Write Memory Request 
Full Read Burffer 
Full Write Buffer 
CPU Cache Access 


OO OO OO OO dë 
ooo oo 2 0 
ooo ooo oF 
e) (e) (e) fe) IN} el (o) UW 
oo OO nN Vë Vë H 


Next Command Please [T, R, S, C, G4, #, -#, Help] >>> 


Figure 4 Stall Timing Display 
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D. 


The cache arguments display allows the user to review the arguments used by the 


CACHE ARGUMENTS DISPLAY 


simulator. Figure 5 shows an example of the cache arguments display. 


Cache Size: 

Block Size: 

Sub Block Size: 
Associativity: 

Word Size: 

Read Cache Acccess Time: 
Read Cache Hit Time: 
Read Cache Miss Time: 
Write Cache Access Time: 
Write Cache Hit Time: 
Write Cache Miss Time: 
Memory Access Time: 


Cache Arguments List 


00008192 
00016 
00004 

04 

00004 

0 


Read Forward: 

CPU Waits For Cache Writes: 
Search Block Buffer: 

Update Read Buffer: 

Remove Read Duplicates: 
Remove Write Duplicates: 
Read Priority: 

Write Priority: 

Read For Write Allocate: 
Write Dirty Block Priority: 
No Priority: 

Trace: 


Check: 

Test: 

Key Board IO: 

Data File Name: 

Screen History Max Index: 
File History Max Index: 


Memory Transfer Time: 

Buffer Cache Access Time: 1 

Read Buffer Size: 04 

Write Buffer Size: 04 

Block Replacement Policy: LRU 

Write Policy: Write Through 
Write Miss Policy: Write Allocate 


SACS.Dat 
0004 
0010 


Next Command Please [ T, R, S, C, G 4, $, -4, Help) >>>) 


Figure 5 Cache Arguments Display 





E. GO TO A SPECIFIC TIME 

Because data traces are usually very long, SACS was given the ability to run to a 
specific time. This allows the user to begin a long trace and inspect the results after a 
reasonable amount of time. If the user is debugging SACS because of a modification or, 
God forbid, there is an original error in SACS, this command will allow the user to advance 


to the last time the error occurred. If the time specified is earlier than the current time, then 
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SACS will temporally turn off the trace, restart the run from the beginning, and stop at the 
desired time. Once SACS is at the desired time, it will turn the trace mode back on. To the 
user, it will appear that SACS went backwards. However, in fact, SACS can not run its 
simulations in reverse. Obviously, if the Desired Time is vary large, then this process 
could take a great deal of time. 
F. INCREMENT TIME 

Increment time allows the user to adjust the time using a relative step size instead 
of an absolute desired time. 
G. DECREMENT TIME 

Decrement time allows the user to adjust the time using a relative step size instead 
of an absolute desired time. Again, SACS must restart the run from the beginning to stop 
at the desired time. 
H. HELP DISPLAY 

The help menu, shown in Figure 5, gives the user simple descriptions of what all 


the trace commands can do. 
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Help Menu 


[T] Trace Display: 
Displays current request, status of memory, and contents 
of buffers. 


Results Display 
Displays a break down of read and write cache hits, and 
buffer hits, including a timing analysis. 


Stall Timing Display: 
Displays histogram of the time spent on each stall. 
Stalls represent time delays in completing a request. 


[C] Cache Arguments Display: 
Display input arguments to SACS. 


[G] Go: Go to end of run. 

[G 4] Go To: Go to Time #. 

[4] Step: Increment Time By #. 
[-#] Back Step: Decrement Time By #. 

[H] Help: Displays this help menu. 


Next Command Please [T. R, S, C, G4, 8, -4, Help] >>>] 


Figure 5 Help Display 
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V. SACS DESIGN 


A. OVERALL STRUCTURE OF SACS 

SACS simulates all events one clock cycle at a time using a global variable named 
Time. Normally, it is preferable to perform timing simulations using event queues so that 
time can advance to the next event. However, in most cache simulations, so many events 
happen in one clock cycle that an event queue would probably not improve the performance 
of the simulator. 

B. MAIN EVENT LOOP 

In the main event loop of SACS, Time is incremented one clock cycle at a time. 
Time is never changed by any other procedure. The requests are entered into the 
simulation from Ger Next Request. Simulation of all events is performed by the Main 
Event Loop calling Cache Model, Memory Model, and Update Cache. 

SACS insures that all events that can be started during a particular clock cycle are 
started, and that all events that can complete during a particular clock cycle do. CPU 
accesses to the cache are given priority over the block buffer cache updates. 

SACS's main loop includes the source code to control testing, checking, and 
tracing. The Desired Time variable is controlled entirely by the Main Event Loop. Desired 
Time represents a user request to advance the simulation to a particular time with the trace 


off. SACS can not run Time backwards. However, if the Desired Tine is less than Time, 
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then Time is reset back to zero and the run is repeated up to the Desireď Time. The user 
can make time requests using arguments "G #", "#", or "-#". 

Throughout Main Event Loop, Cache Waiting For is checked to see if it's equal to 
Nothing. This indicates that the last request has been serviced and that the cache is ready 
for the next request. The procedures that model specific events as Read Hit, Read Miss, 
and Access Cache are called repeatedly during their simulations. They utilize Cache 
Waiting For and Time to determine what to do next. If any of these procedures need to 
wait for a period, either to simulate an access or because a resource 1s not available, then 
they will set Cache Waiting For to the appropriate value. The modeling procedures in 
Memory Model work the same way using Memory Waiting For. 

Whenever SACS finds an error or a discrepancy then the boolean variable 
Discrepancy Found is set to Yes. This forces SACS into a trace mode so that the user may 
try to identify the cause of the error. In test mode, a discrepancy forces SACS out of test 
mode so that the trace file that caused the error is not erased by a new file. 

C: CACHE MODEL 

Cache Model makes all the necessary calls to simulate cache memory. Cache 
Model decides which calls to make based on the values of Cache Hit and Request. This 
function is called every time Time is incremented. If there are no read or write requests 
waiting to be completed, the function does nothing. The value of Cache Hit will remain 
Unknown until the appropriate cache access time has expired. Then, Cache Model will call 


[s Request A Hit to determine if the request is a hit or a miss. 
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l. Is Request A Hit 
Is Request A Hit determines if the request is a hit or a miss, and sets Cache 
Hit to the appropriate value. /s Request A Hit will find the Set Number that the data is 
supposed to be in. Then, all Cache Block Addresses in that set will be checked to see if 
they equal the B/ock Address for that request. If the correct block is found, then all sub 
blocks that are required to satisfy the request will be inspected for validity. If they are valid 
then Cache Hit will equal Yes. 
2 Read Hit 
Read Hit 1s called to simulate a cache hit during a read request. Read Hit 
simply finishes simulating the cache access for the hit. Read Cache Hit Time is the time 
required to send the data from the cache to the CPU. Note that the time to locate the block 
in the cache is simulated in Cache Model. Read Hit is called repeatedly while Time is 
incremented until Access Cache returns with Cache Waiting For equal to Nothing. Access 
Cache will return Cache Waiting For equal to Read Cache Request until the Read Cache 
Hit Time has expired. 
3. Read Miss 
Read Miss 1s called to simulate a cache miss during a read request. Read 
Miss first simulates the time it would take to perform all the block management for a read 
miss. This time is called Read Cache Miss Time. Once that time has expired, Read Miss 


will call Select Block Victim to pick a block in the set. When Select Block Victim returns 
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with Cache Waiting For equal to Nothing the Request Block Number will contain the new 
block number where the data will be placed. 

Once the new block has been chosen, Read Miss will call Add To Read 
Buffer. If Read Forward is selected, then Required Size for the memory request will be 
equal to the Request Size. However, if it is not, then Required Size for the memory request 
will equal Block Size. The Required Size in read memory request tells the Memory Model 
how much of the requested data must be read into the Block Buffer before resetting Cache 
Waiting For back to Nothing. By setting Required Size equal to Block Size, Read Miss is 
forcing Memory Model to read in the entire block before setting Cache Waiting For back to 
Nothing. Once the Memory Model has received the data, it is assumed to be available to 
the CPU during that clock cycle. 

4. Write Hit 

Write Hit 1s called to simulate a cache hit during a write request. Write Hit 
will first simulate the time to write the data to the Request Block Number in the cache. The 
time to locate the block was simulated by Cache Model. Once Write Cache Hit Time has 
expired then Write Hit will perform the block management for the request. The block 
management is dictated by the Write Policy. For a Write Back policy, the sub blocks 
written to must have their dirty bits set. This is done by Ser Dirty Bit. For a Write 
Through policy, the memory request must be entered into the write buffer. This is done by 


Add To Write Buffer. 


28 





5. Write Miss 

Write Miss is called to simulate a cache miss during a write request. Write 
Miss will first simulate the time needed to make all memory requests. This time is called 
Write Cache Miss Time. This 1s only the time required to make the requests, not the time 
required to complete them. The time to determine that the correct block was not in the 
cache memory was simulated by Cache Model. The memory requests are entered into the 
buffers after the Write Cache Miss Time expires. The memory requests are dictated by the 
Write Miss Policy. The simplest policy is Write Around. For a Write Around policy, the 
write data is placed in the Write Buffer by Add To Write Buffer. Write Allocate, however, 
is the toughest simulation in SACS. Write Miss must first choose a block to put the new 
data in. This is done by Select Block Victim. Block data not provided by the write request 
has to be read in. This read request is made by Add To Read Buffer. The read address is 
calculated by adding the request size to the address. Because new address may be in the 
next block, the Block Size may have to be subtracted to make the addition modulo. Sub 
blocks that were written to in there entirety will have there valid bits set to reflect the 
presence of the data provided by the CPU. However, if only part of a sub block was 
written to, then the Cache Valid Bit will not be set. 

Write Miss uses the Write Policy to dictate how the write data 1s to update 
the memory. For a Write Back policy, dirty bits are set by Set Dirty Bits. For a Write 


Through, the data is added to the Write Buffer by Add To Write Buffer. 
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6. Access Cache 

Access Cache is called to simulate the CPU accessing the cache. Access 
Cache first waits for the cache not to be busy. The only reason it could be busy is if the 
Block Buffer is in the process of updating the cache. During this time, Access Cache will 
retum Cache Waiting For equal to CPU Cache Access. Once the cache is not busy then 
Cache Busy is set to Yes, locking out the Block Buffer from accessing the cache. Then, 
Cache Waiting For will be set equal to Waiting For Request. This is a local variable 
passed by the caller. It will either be equal to Read Cache Access or Write Cache Access. 
Then, Cache Busy is set for the time specified by Request Time. Request Time is a local 
variable. It could equal any of the hit, miss, or access times. Once Request Time has 
expired then Access Cache will set Cache Busy equal to No, and Cache Waiting For equal 
to Nothing. 

7. Select Block Victim 

Select Block Victim chooses the next block to be used and writes the dirty 
sub blocks out to the Write Buffer. Select Block Victim first surveys the cache set that the 
Request Address maps to. The survey includes finding the block that was least recently 
accessed. This Block Number is stored in LRUBlock. Once the set has been surveyed then 
the Replacement Policy dictates how the block is chosen. For the LRU policy, Request 
Block Number is set equal to LRUBlock. For the FIFO policy, Cache Next Block keeps 
track of the next victim block for each set. Cache Next Block is initialized to all zeros 


during the beginning of arun Therefore, it must be checked to see if it is between the first 
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and last blocks for the set. If it 1s not, then Cache Next Block for Set Number ís reset to 
First Block. Once Select Block Victim knows it has a valid Cache Next Block then Request 
Block is set equal to it. Then, Cache Next Block for the Set Number is incremented. For 
RAND policy, the block number is chosen randomly from all the blocks in the set. 

Select Block Victim writes all dirty sub blocks to the write buffer using Write Dirty 
Sub Blocks. Write Dirty Sub Blocks takes care of clearing the dirty and valid bits in the 
block. Once Select Block Victim 1s called and it gets to the bottom of the function with 
Cache Waiting For equal to Nothing, then the Cache Block Address for the Request Block 
Number 1s set equal to the block address of Request Address. 

8. Set Dirty Bits 

Set Dirty Bits sets the dirty bits for all sub blocks that contain data that was 

modified by a write request. 

9, Write Dirty Sub Blocks 

Write Dirty Sub Blocks is called to simulate writing all the dirty sub blocks 

in the Request Block. Write Dirty Sub Blocks not only clears all the dirty bits, it also clears 
all the valid bits. Write Dirty Sub Blocks prepares a block to receive new data, and is 
called after a block has been selected as a victim. Write Dirty Sub Blocks will search the 
block for consecutive dirty blocks and splice them together into one write request. The 
write request is then added to the Write Buffer. All of the sub blocks that make up the 
request will have their dirty and valid bits cleared. This process of searching and writing 1s 


repeated until all the bits are not dirty. Then, all the valid bits are cleared. 
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10. Add To Read Buffer 

Add To Read Buffer takes the elements of a reguest and adds the reguest to 
the Read Buffer. It will perform all of the searches and updates necessary to support the 
appropriate scoreboarding protocols. 

Add To Read Buffer will begin by searching the cache and Block Buffer for 
each byte in the request, starting at the beginning of the request. Every time a byte is found 
in one or the other, the Address is incremented while Size and Required Size are 
decremented. This simulates removing the available data from the front of the request. 
Then, Add To Read Buffer will search the cache and Block Buffer for the data at the end of 
the request. Every time a byte is found, the Size of the request is decremented by one. If 
the byte was a required byte then the Required Size is also decremented. This simulates 
removing any data available from the end of the request. Add To Read Buffer is either left 
with a request that has a Size equal to zero or the end points are both needed from memory. 
If the Required Size is zero then the request is a buffer hit, otherwise the request is a buffer 
miss. If the request is already a cache hit then the buffer hit is for some block management 
request. These kinds of buffer hits are not recorded because it would confuse the Results 
Display by making it possible to get a hit rate greater than 100%. If the Size is not zero 
and Remove Read Duplicates 1s equal to No then the request is added to the end of the 
Read Buffer using Append. Append is a buffer utility that adds the request to the end of the 
buffer. The request must be added to the end of the buffer in order not to interfere with 


Memory Model. which may be in the middle of a memory read. If Remove Read 


Duplicates is equal to Yes then the first byte in the request will be spliced into the Read 
Buffer. 

Splice is another buffer utility. Splice will first search the Read Buffer for the byte. 
If it can't find a request in the buffer that contains the byte then it will search for a memory 
request that is getting data from the same block. If one is found then the request is 
modified to include the new read byte request. If no suitable request can be found then 
Splice will add a one byte request to the Read Buffer. The Address 1s then incremented 
while Size and Required Size are decremented. Then, the cache and Block Buffer are 
searched for the next byte. If it is not found then the next byte is spliced into the Read 
Buffer. This process is repeated until all of the bytes of the request have either been spliced 
into the Read Buffer or found. 

The Buffer Hit is normally defined as when the data is available but not in the 
cache. However, in order to support the testing of SACS, the definition of a buffer hit is 
revised to mean that a request was found to have accrued recently, and that given time to 
complete all block management requested data would have been in the cache. This allows 
Test SACS to predict the hits of a test run without taking into account the time it takes to 
perform the block management. 

Every time a request is spliced into the read or write buffers, the Time To Execute 
and Completion Time Estimate must be recalculated. The new time estimates are 


performed by Calculate Time Estimates. 
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11. Search Cache 
Search Cache is called by Add To Read Buffer to find any parts of the 

request that may already be located in the cache. This must be done because if a read 
request follows a write request using a write allocate policy, then part of the read may be in 
the cache while the rest may still need to be read from memory. Search Cache checks all 
Cache Block Addresses in the cache set. If any of the cache block addresses equal the 
block address of the byte, then Scarch Cache checks the Cache Valid Bit for the sub block 
that the byte is located in. If the sub block is valid then Search Cache returns Yes. 

12. Add To Write Buffer 

Add To Write Buffer adds one record to the write buffer. It also updates the 

Read Buffer if the Update Read Buffer argument is asserted. The process of updating the 
Read Buffer is simply changing the requests so that data made available by the write 
request is not requested from memory. Update Read Buffer should not be used unless the 
word and sub block sizes are equal. This is because a write request may reduce a read 
request to where the read request will not be large enough to validate a sub block. The 
write request may also be unable to set any valid bits because of sub block alignment. The 
result is that a sub block that was suppose to be read in is not. 
D. MEMORY MODEL 

Memory Model makes all the necessary calls to simulate main memory. Memory 
Model decides which calls to make based on Memory Waiting For. This function is called 


every time Time is incremented. If there are no read or write requests waiting to be 
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completed, the function does nothing. Memory Model contains a loop that forces the 
procedure to continue modeling until 70A and TOD are not equal to Time. This insures 
that if there are any events that occur in zero clock cycles then the next event is allowed to 
start. 

Memory Model calls Select Memory Request to choose a request from either the 
read or the write buffers. Memory Model calls Start Reads and Start Writes to simulate 
accessing memory and receiving the first word of a memory request. Continue Reads and 
Continue Writes are then called to simulate the memory transfer of the following words of 
data. 

1. Select Memory Request 

Select Memory Request is called when memory is waiting for nothing. 
Select Memory Request chooses a request from either the read or write buffers based on 
priority. The request is not returned however, and the request is left at the top of the buffer 
with its Priority set to zeros and Access In Progress set equal to Yes. If a request is found, 
then Memory Waiting For s set to Memory Read Request or Memory Write Request, 
depending on whether the request was found in the read or write buffer. 

2: start Reads 

Start Reads begins a read request, simulating the first word read from 
memory. The time to complete this read is called Memory Access Time. The Block Buffer 
iS initialized in preparation to receive the new data words. If Block Waiting For is not 


equal to Nothing then Start Reads will have to wait before allowing the new memory read 
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request to start. If Start Reads does have to wait for the cache then Memory Waiting For is 
set equal to Cache Update, otherwise Memory Waiting For is set to Memory Read Access. 
The new block record is equal to the Read Buffer with its sizes set to zero. This gives the 
Block Memory Request the same block number as the Read Memory Request. The 
Address is aligned to Word Size. The Address must be aligned because the words read in 
will be aligned to Word Size. The new Block Memory Request is simply pushed onto the 
Block Buffer. Block Waiting For is set equal to Memory Block Transfer to indicate that 
data is being transferred from memory to the Block Buffer. 
3: Continue Reads 

Continue Memory Reads continues the memory read request started by 
Start Memory Reads. It simulates every read from memory other than the first word, 
which is simulated by Start Memory Reads. The time to complete each word transfer is 
equal to Memory Transfer Time. The block and read buffers are altered every time a word 
is read from memory. Once a request is complete, it is removed from the Read Buffer and 
Memory Waiting Foris reset to Nothing. Block Waiting For is set to Block Cache Access 
in preparation to transfer the new data to the cache. If the Complerion Time Estimate for 
the memory read request is not equal to Time then a time prediction error is raised. 

4. Start Memory Writes 

Start Memory Writes begins a memory write request, simulating the first 

word written to memory. The time to complete this one word write is called Memory 


Access Time. Memory Waiting For is set to Memory Write Access. 
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5. Continue Memory Writes 

Continue Memory Writes continues the memory write request started by 
Start Memory Writes. Like Continue Memory Reads, it simulates every write to memory 
other than the first word, which is simulated by Start Memory Writes. The time to 
complete each word transfer 1s equal to Memory Transfer Time. The Write Buffer is 
altered every time a word is written to memory. Once the memory write request is 
complete, it is removed from the Write Buffer, and Memory Waiting For 1s reset to 
Nothing. If the Completion Time Estimate for the memory read request is not equal to 
Time when the request is completed then a time prediction error is raised. 

6. Update Cache 

Update Cache simulates entering data form the B/ock Buffer into the cache. 
Update Cache first checks whether or not the cache is busy. If it is not, then Cache Busy is 
asserted and Block Waiting For is set equal to Block Cache Transfer. The Block TOA is 
calculated to enable Calculate Time Estimates to predict the completion times for 
additional memory read requests in the buffer. If the cache is busy then the previous 
memory request time completions may be wrong. That is because all of the last estimates 
counted on the old 5/ock TOA. Therefore they all must be recalculated. 

Once the Buffer Cache Access Time has expired then Block Waiting For is 
Set equal to Nothing and the Cache Busy is deasserted. The read data must then be 
removed from the Block Buffer. The appropriate sub blocks in the cache will then have 


their dirty bits cleared and valid bits set. 
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di Add A Word To Memory Request 
Add A Word To Memory Request adds a word to a Memory Request as if it 
had been read in from memory. The address is first aligned to Word Size. Then, the size is 
incremented by Word Size. This simulates the data being added to the request. 
8. Remove A Word From Memory Request 
Remove A Word Form Memory Request removes a word from a Memory 
Request as if it had been written to memory. A copy of the Address is first stored in Old 
Address. Then, the Address is word aligned and incremented by Word Size. The Required 
Size and Size are then decremented by the difference of the new Address and the Old 
Address. Finally, if the Address is outside the range of the original block, then Address is 
decremented by B/ock Size to simulate modulo addition. This simulates removing a word 
from the memory request, taking into account word and block alignment constraints. 
E. TIME ESTIMATES 
Time estimates are performed to provide a method of testing Cache Model, and 
Memory Model's handling of the read and write buffers. These two procedures are located 
in "TimeEst.c" 
l. Update Time To Execute 
Update Time To Execute calculates the time to complete a memory transfer 
given Memory Request. Memory Request could be a read or write request in a buffer. 
Update Time To Execute changes the Time To Execute field to the new value. Time To 


Execute 1s calculated by first finding the number of Words To Be Transferred. If the 
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Memory Request is not being accessed then the Time To Execute is simply the Access Time 
plus the Transfer Time multiplied by one less than Words To Be Written. If the Memory 
Request is in progress then the new Time To Execute is dependent on TOA or TOD of the 
next word. Memory Waiting For dictates whether to use the TOA or TOD. If Memory 
Waiting For is equal to Cache Update then the request has not actually begun transferring 
data. Therefore, the Time To Execute can be calculated as if the read request is not in 
progress. 
2. Calculate Time Estimates 

Calculate Time Estimates updates the Completion Time Estimates for each 
request in both the read and write buffers. This function is called whenever the Cache 
Model adds to the read or write buffers. Calculate Time Estimates must be called every 
time new data is entered into the buffers. This 1s because all previous estimates did not 
take into account the new data requested. Calculate Time Estimates first orders all entries 
in both the Read Buffer and the Write Buffer by pnority. Then, Calculate Time Estimates 
steps though both buffers simultaneously, each time picking the request that has the highest 
priority and adding the time to execute to the Time Estimate. The Time Estimate becomes 
that requests Completion Time Estimate. This process is repeated until all requests have a 
new Completion Time Estimate. Time To Execute, for cache request, is updated before it 


IS used to calculate the Time Estimate. 


DO 


VI. PROGRAM VALIDATION 


A. TESTING SACS 

Program validation was considered to be a paramount issue in designing and 
implementing SACS. The debugging technigues for SACS were engineered during the 
early planning phases, before any code was written. In fact, there was a great deal of 
energy spent trying to make SACS a general event simulator. Not only would this have 
made it easier for the user to alter the protocols, but more importantly, it would have been 
easier to test the program. It would have been easier because the number of different kinds 
of event transitions would have been less than the number of different cache argument 
permutations. This method was aborted because data that was stored in the cache and the 
buffers was completely different. Another problem that plagued this method was that the 
scoreboarding techniques were unique for each buffer. Having abandoned the previous 
method, and recognizing that SACS would have dozens of input parameters ( 37 to date), a 
great deal of concern developed over how the program could be tested. It was decided that 
hand testing would prove to be ineffective in eliminating most or all of the programming 
errors. Therefore, an automated testing routine was developed. The testing routine was 
incorporated into the source code of SACS and can be activated using the -rest argument. 
When the program is in the test mode, it goes into an infinite loop generating 


pseudo-random load and store instructions. Each trace Is processed using the same code as 
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if the trace was generated by a designer. Each time a new trace run is executed, the input 
parameters are randomized. This testing method is the backbone of all other validation 
methods for SACS. Other error checking is performed during this process. However, the 
random trace and random argument testing is the best method to ensure that all lines of 
code in SACS get executed during the test phase of SACS. This prevents SACS from 
experiencing a catastrophic failure during an actual simulation because almost all 
instructions are executed during the testing phase. SACS tries to predict the number of 
read and write hits for each run. These predictions are compared to the number of cache 
and buffer hits if the input arguments are expected to make the cache and buffer hits reflect 
the predictions. An example of when the input arguments would make it impossible to 
predict a hit or a miss is when the rand block replacement policy is used. A block of data 
that has just been read into the cache may be selected as a victim. This makes it impossible 
to predict which blocks will be in the cache at the beginning of the next request. Another 
example is when a read forward policy is used and the block buffer is not searched. Data 
expected to be in the cache may be in the Block Buffer, or in the Read Buffer, waiting to 
complete the block transfer. This requires that the predicted hits only be compared when 
the block and read buffers are searched. It also requires that during the test mode, buffer 
hits will include the read buffer. Policies that can not be checked for predicted hits are 
allowed in the test because they can be checked for other things including the simple, yet 


important requirement that the program does not spontaneously abort. 
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The instructions that are randomly generated for a test trace are seeded from 64 test 
vectors. These test vectors each have 7 read or write instructions. The number of these 
vectors to be used to generate a trace is randomly chosen. The actual test vectors to be 
used are also randomly chosen. Each test vector is assigned a random set of block 
addresses. Each of the block addresses for a particular test vector will map to the same set 
in the cache. The actual data address for each request is formed by taking the block 
address and adding a random number such that the data address is still in the same block. 
The size is also chosen randomly in such a way that the request does not violate block 
alignment. 

Once all the test instructions have been created, they are randomly shuffled in such 
a way that the final number of hits and misses will remain the same as predicted. 

B. CHECKING COMPLETION TIME 

The timing analysis of SACS is so important that it was decided that every timing 
test that could be performed would be performed. SACS simulates events based on the 
current time only because some events can be predicted, such as the time that a buffer 
request would be removed from a buffer. A good timing test would be to calculate the 
estimated time of completion. Then, check to see if that estimated time is the same as the 
time that the request is removed from the buffer. If they do not match then an error is 
indicated. This kind of error checking goes on during every run whether it's a test run or a 


user's run. 
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© CHECKING GLOBAL VARIABLES 

SACS uses 82 global variables. Approximately half of the global variables are 
constant during a single run. These variables mostly represent input parameters, and 
although they are changed in between test runs, they remain constant for the rest of the 
trace run. SACS was written in C, a powerful language that permits the programmer to 
create some powerful and elusive bugs. Specifically, C allows assignments to be buried in 
logical expressions. This capability could easily result in altering input parameters instead 
of checking a parameters value. To avoid this kind of error and others like it, copies of all 
constant global variables are made before the beginning of the trace run. At the end of 
every simulated clock cycle these variables are compared to their original copies. If a 
discrepancy is found then an error is indicated. 

Global variables that are not constant are also inspected. They are inspected to 
ensure that they are all within acceptable boundaries. These boundaries are not always 


constant. For example, histogram index and total time should always exceed Time. 
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VII. SAMPLE RUNS 


A. ENAMPLE SACS SIMULATION RUN 

In the first simulation run for SACS the default parameters were used. This run 
will demonstrate a write allocation miss and a write through hit. This run will also 
demonstrate a read miss that takes advantage of removing duplicates, and how a write 
request can update the read buffer. Table 4 shows the trace data used for the simulation 


run. 


Table 4 TRACE DATA FOR RUN 


Requent Request Time Until 


Akire: Next EECH i 


e Sree se 
r indicate der EI 
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The Request Type is either a read or a write request. Read requests are indicated 
with a lower case "r". Write requests are indicated with a lower case "w". The address is 
read as a long hexadecimal integer. The Request Size is a long unsigned decimal integer. 
It represents the size in bytes. Time Until Next Request is the time between when the 


CPU's current request is complete and when the CPU makes the next request. The 


simulation run was performed by loading the trace data from Table 4 into an ASCII data 
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file named "SACS.Dat". Then, SACS was started with the trace mode on. The first trace 


display that SACS produced is shown in Figure 6. 


Current Reguest: Write Time: 1 
Address: 00000100 Next Reguest Time: 2 

Size: 04 

Cache Waiting For: Write Cache Reguest 

Memory Waiting For: Nothing Cache Hit: Unknown 
Block Waiting For: Nothing Buffer Hit: Unknown 


/ 


Set Block Address V 
00016 00000 00000000 O 
00000 00000000 0 

0 

0 


00000 00000000 
00000 00000000 


Read Buffer Address Req. Block Priority Time Req. Comp. Time 
Write Buffer Address Size Req. Block Priority Time Reg. Comp. Time 
Block Buffer Address Size Reg. Block Priority Time Req. Comp. Time 


Next Command Please [ T, R, S, C, G 4, 4, -4, Help] >>>) 


Figure 6 Trace Display For Time-1 





Figure 6 shows the status of SACS after the first clock cycle. The Cache Waiting 
For field shows that SACS is modeling the cache access. Memory Waiting For is Nothing 
because the cache does not know if the request is a hit or a miss. Block Waiting For is 
Nothing because no read requests have started. The Next Request Time indicates that the 
CPU will send another request at Timc equal to 2. Cache Hit and Buffer Hit are Unknown 
because the cache block still has not been accessed. The request will be mapped to set 


number 16, block 64. 
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The trace display for Time egual to 2 is shown in Figure 7. This display shows that 
the CPU has made the second write request. Again, the Cache Waiting For indicates that 
the cache is accessing block 64. The Memory Waiting For indicates that memory is 
accessing the first word in memory for the last write request. The 7OD indicates that the 
first word will be written to memory at Time egual to 5. Cache and buffer hits are again 
Unknown because block 64 has not been accessed. The set data indicates that the last write 
reguest at 100 validated the first sub block. The Reaď Buffer has the remaining data 
needed for block 64. The Reg. field is the number of bytes required to satisfy the CPU 
request. None are required in this case because the data was only needed to fulfill a block 
management requirement. The Write Buffer shows the last write request. It also predicts 


that the memory write request will be complete at Timc egual to 5. 


Current Request: Write Time: 

Address: 00000108 Next Request Time: 
Size: 08 TOD: 

Cache Waiting For: Write Cache Request 

Memory Waiting For: Memory Write Access Cache Hit: 

Block Waiting For: Nothing Buffer Hit: 


Set Block Address V/D V/D 
00016 00064 00000100 10 00 
00065 00000000 0 O 

00066 00000000 0 0 

00067 00000000 00 


0 0 
0 0 
0 0 


Read Buffer Address Size 5 Block Priority Time Reg. Comp. Time 
00000104 12 00 00064 T2 5 10 


Write Buffer Address Size Req. Block Prioritv Time Req. Comp. Time 
00000100 04 00 00000 00 3 5 


Block Buffer Address Size Req. Block Priority Time Req. Comp. Time 


Next Command Please [ T, R, S, C, G 4, $, -&, Help] >> 


Figure 7 Trace Display For Time-2 
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The next display is for Time egual to 3, and is shown in Figure 8. This display 
shows that cache is still working on the last write request. Cache Waiting For still 
indicates Write Cache Request because the default for a write hit requires one clock cycle 
after the cache has been accessed to update the cache. The memory is still waiting for the 
memory access of the first write memory reguest. The Nexr Reguest Time indicates that 


the CPU is waiting for the cache to finish with the last write request. 


Current Request: Write Time: 

Address: 00000108 Next Request Time: 
Size: 08 TOD: 

Cache Waiting For: Write Cache Request 

Memory Waiting For: Memory Write Access Cache Hit: 

Block Waiting For: Nothing Buffer Hat: 


Set Block Address V/D V/D 
00016 00064 00000100 1 O 
00065 00000000 O O 
00066 00000000 0 0 
00067 00000000 0 0 


Read Buffer Address Size ; Block Priority Time Req. 
00000104 12 00 00064 12 5 


Write Buffer Address Size Req. Block Priority Time Req. 
00000100 04 00 00000 00 3 


Block Buffer Address Size Req. Block Priority Time Req. 


Next Command Please [ T, R, S, C, G 4, $, -#, Help] >>MJ 


Figure 8 Trace Display For Time=3 





Figure 9 shows the display for Time 1s equal to 4. The last write request has 
completed and the data provided by the write request was placed in block 64. As a result, 
the last two sub blocks are valid. The data was also placed into the Write Buffer. At first, 


It seems as thouch the two write memory requests should have been combined. The 
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resulting reguest would have had an address of 108 anda size of 12. Because words are 
accessed in memory in modulo form, the data for the first sub block would have been 
accessed last. However, because the last memory write reguest was in progress, the 
reguest could not modify its starting address. Therefore, two different reguests resulted, 
and the Read Buffer's memory request size has been reduced by 8 bytes. This is an 
example of updating the Read Buffer with write data. This scoreboarding policy is a 
default for SACS, and can be disabled. The result is that the read request does not have to 


access data that was provided by a write request. 


Current Request: Read Time: 4 
Address: 00000104 Next Request Time: 6 

Size: 02 TOD: 5 

Cache Waiting For: Read Cache Request 

Memory Waiting For: Memory Write Access Cache Hit: Unknown 
Block Waiting For: Nothing Buffer Hit: Unknown 


Set Block Address V/D V/D 
00016 00064 00000100 0 0 
00065 00000000 0 0 

00066 00000000 0 0 

00067 00000000 0 0 


Read Buffer Address Size Reg. Block Priority 
00000104 04 00 00064 12 


Write Buffer Address Size Reg. Block Priority 
00000100 04 00 00000 00 
00000108 08 00 00000 Li 

Block Buffer Address Size Req. Block Priority 


Next Command Please [ T, R, S, C, G #, #, -#, Help) >> 


Figure 9 Trace Display For Time=4 
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Figure 10 shows the trace display for Time egualto 5. The last read reguest has 
turned out to be a miss. The buffers were also no help. At first glance, it might seem as 
though the read buffer should have provided a buffer hit. This would have been true if 
SACS were in a test mode. However, in a non test mode, the read buffer is not searched 
because the data is not reallv available. It still has to be read in from memory. The first 
write memory request starting at address 100 has completed, as predicted at Tine equal to 
5. The next memory request was chosen to be the write request because it had a high 
priority of 11, versus the read memory request with a priority of 12. Unfortunately, the 
request began before the cache could raise the priority to 10. Once the write request began, 


the priority went to O to prevent interruption. 


Current Request: Read Time: 

Address: 00000104 Next Request Time: 
Size: 02 TOD: 

Cache Waiting For: Read Memory Request 

Memory Waiting For: Memory Write Access Cache Hit: 

Block Waiting For: Nothing Buffer Hit: 


Set Block Address V/D V/D 
00016 00064 00000100 1 0 00 
00065 00000000 O O 

00066 00000000 O O 

00067 00000000 O O 


0 0 
0 0 
0 0 


Read Buffer Address Size : Block Priority Time Req. Comp. Time 
00000104 04 00064 LO 3 12 


Write Buffer Address Size : Block Priority Time Req. Comp. Time 
00000108 08 00000 00 4 9 


Block Buffer Address Size Z Block Priority Time Reg. Comp. Time 


Next Command Please [ T, R, S, C, G 4, $, -#, Help] >>0 


Figure 10 Trace Display For Run #1, Time=5 
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From the TOD in Figwre 10, itis obvious that little will happen until at least the first 
word is sent to memory. The display trace for Time equal to 8, when the first word is . 
written to memory, is shown in Figure 11. It shows how SACS adjusts its buffers to 
represent individual words sent or rec: . «ed from memory. The Memory Waiting For 
switched to Memory Write Transfer, illustrating the transition from memory access to 
memory transfer. The TOD shows that the write will be complete at Time equal to 9, 


which ts a lot better than the 3 clock cycles normally used to access memory. 


Current Request: Read Time: 

Address: 00000104 Next Request Time: 
Size: 02 TOD: 

Cache Waiting For: Read Memory Reguest 

Memory Waiting For: Memory Write Transfer Cache Hit: 

Block Waiting For: Nothing Buffer Hit: 


Set Block Address  V/D 
00016 00064 00000100 1 0 
00065 00000000 0 0 

00066 00000000 0 0 

0 0 


00067 00000000 


Read Buffer Address Size : Block Priority Time Req. Comp. Time 
00000104 04 00064 10 3 12 


Write Buffer Address Size : Block Priority Time Req. Comp. Time 
0000010C 04 00 00000 00 4 9 


Block Buffer Address Size Req. Block Priority Time Req. Comp. Time 


Next Command Please ( T, R, S, C, G 4, $, -#, Help] >>>0 


Figure 11 Trace Display For Time=8 
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Figure 12 shows the completion of the write memory reguest, and the beginning of 
the read memory request at Time equal to 9. The Block Buffer has also been prepared t | 
receive the read memory data. The Block Waiting For indicates that the Block Buffer is 
busy receiving read data from memory. The TOA shows that Time 12 is when the read 


memory request will be complete. 


Current Request: Read Time: 

Address: 00000104 Next Request Time: 
Size: 02 TOD: 

Cache Waiting For: Read Memory Request 

Memory Waiting For: Memory Read Access Cache Hit: 

Block Waiting For: Memory Block Transfer Buffer Hit: 


Set Block Address V/D V/D / / 
00016 00064 00000100 10 00 
00065 00000000 0 0 
00066 00000000 0 0 
00067 00000000 0 0 


Read Buffer Address i Req. Block Priority 
00000104 02 00064 10 


Write Buffer Address Size Req. Block Priority 


Block Buffer Address Size Req. Block Priority 
00000104 00 00 00064 00 


Next Command Please [ T, R, S, C, G 4, $, -4, Help) >>M) 


Figure 12 Trace Display For Time=9 
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Figure 13 shows the completion of the read memory reguest at Time egual to 12. 
The Cache Waiting For indicates Nothing because the reguest was satisfied when the 
reguired bytes arrived in the block buffer. The memory has nothing to do because both the 
read and the write buffers are empty. The simulation is not finished however, because the 
block buffer still has to update the cache with the new block data. Block Waiting For 


shows that the transfer is in progress. 


Last Request: Read Time: 

Address: 00000104 Next Request Time: 
Size: 02 

Cache Waiting For: Nothing 

Memory Waiting For: Nothing Cache Hit: 

Block Waiting For: Block Cache Transfer Buffer Hit: 


Set Block Address V/D V/D 
00016 00064 00000100 O 00 
00065 00000000 0 0 

00066 00000000 0 O 

00067 00000000 00 


0 0 
0 0 
0 0 


Read Buffer Address Size Reg. Block Priority Time Reg. 
Write Buffer Address Size Reg. Block Priority Time Req. 


Block Buffer Address Size Req. Block Priority Time Reg. 
00000104 04 00 00064 00 1 


Next Command Please ( T, R, S, C, G 4, 4, -4, Help] >>>) 


Figure 13 Trace Display For Time=12 
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Figure 14 shows the trace display for Time egual to 13. This display shows how 
the block buffer updated block 64. One word of data was provided at address 104, making 
the second sub block valid. Once the block transfer was completed, SACS removed the 


memory request from the block buffer. 


Last Request: Read Time: 

Address: 00000104 Next Request Time: 

Size: 02 

Cache Waiting For: Nothing 

Memory Waiting For: Nothing Cache Hit: Unknown 
Block Waiting For: Nothing Buffer Hit: Unknown 


Set Block Address  V/D 
00016 00064 00000100 10 1 
00065 00000000 0 0 O 
00066 00000000 0 0 0 
00 0 


00067 00000000 
Read Buffer Address Size Reg. Block Priority Time Reg. 
Write Buffer Address Size Reg. Block Priority Time Reg. 
Block Buffer Address Size Reg. Block Priority Time Reg. 


Next Command Please [ C, G4, 4, -4, Help] >> 


Figure 14 Trace Display For Time=13 
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Figure 15 shows the results display. This display is always shown at the end of the 
run. It is interesting to note that even with the SACS default parameters, which lean 
toward providing the fastest response time to all CPU reguests, the average access time for 
the one read miss was 8 clock cycles. Had this simulation been done with Dinero HI, the 
user could only have assumed that a 2 byte read would have taken the memory access time 


of 3 clock cycles. 


Requests Break Down 


Number Number Number 
of of of Miss 
Requests Cache Hits Buffer Hits Rates 


1 0 0 100.00$ 
2 1 0 50.00$ 
3 1 0 66.67% 


Reguest Time Histogram. 
Ave 
Access 
Time=00  Time-01 Time=02 Timez03 Time>=04 Total Time 
Read 0 0 0 0 1 8 8.000000 
Write 0 1 1 0 0 3 1.500000 
Ideal 2 0 1 0 0 2 


Next Command Please [ T, R, S, C, G#, #, -#, Help) >>0 


Figure 15 Results Display 
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VIII. CONCLUSION 


For more than a decade, caches have been designed and built. Despite the time and 
effort spent on cache designs, there seems to be no one design that has emerged as the best 
cache design. Even the most basic choices, such as associativity, block size, and whether 
to use a unified cache or two separate data and instruction caches, has not been a clear 
choice, or at least the correct choice was not agreed upon by all concerned. 

The diversity of cache designs has been caused by budget constraints, changing 
memory technology, and changing CPU bandwidth requirements. Without proper timing 
information, matching the correct cache to the architecture is more of an art than a science. 
SACS offers a powerful tool in the early planning phase of a cache design. Its large set of 
scoreboarding, block management, and cache memory arguments allow the designer to 
survey different designs quickly. SACS is well documented and provides the designer with 
a number of debugging tools. including self-testing and global variable bounds checking, 
This makes modifying SACS to simulate a unigue design feature extremely easy compared 
to other programs. 

As mentioned throughout this paper, the most critical aspect of SACS is its ability 
to provide the designer with the average access time. Since the ultimate purpose of the 
cache is to minimize the average access time, any simulator that does not provide this 


number can only hope to provide the designer with superficial and misleading data. 
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Future developments of SACS will include more elaborate timing information. The 
number of histograms will expand to include what the CPU, memory, and block buffer 
were waiting for during a run. A new stall histogram will be introduced that will allow the 
user to easily modify SACS to analyze any combination of conditions. For example, how 
many times does a read request wait for access to the cache memory while an old write 
miss request updates the allocated block. A new global variable will allow the user to 


change all the histogram displays to probability density tables. 


56 


LIST OF REFERENCES 


Patterson, D. A., and Hennessy, J. L., Computer Organization « Design 
The Hardware Software Interface, p. 458-481, Morgan Kaufmann 
Publishers, Inc., 1994. 


Jouppi, N. P., "Cache Write Policies and Performance," Proccedings of the 
20th Annual Internanonal Symposium on Computer Architecture, p. 191-201, 


May 1993. 


Smith, A. J., "Cache Memories," Compunng Surveys, vol. 14-3, p. 473-530, 
September 1982. 


Hennessy, J. L., and Patterson, D. A., Computer Archircctmre, A Ouannranvo 
Approach, p. 403-425, Morgan Kaufmann Publishers, Inc., 1990. 


Hill, M. D., and others, "Wisconsin Architectural Research Tool Set," Computer 
Architecture News. v. 21-4, p. 8-10, September 1993. 


57 


APPENDIX 


SOURCE CODE FOR SACS 
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This program is provided "as is" any financial, personal or property 
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Still Another Cache Simulator 


Description- 
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declarations of all functions used in SACS, 
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#ifndef _ CACHE.H 


#define ^ CACHE.H 


$define ClearScreen "ClearScr" 
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Listed below are the enumerations used in the SACS environment. 
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No, 
Yes, 
Unknown 
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None, 

Read, 

Write, 
NumberOfRequestsAvailable 
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ERU, 

FIFO, 

RAND, 
NumberOfReplacementPoliciesAvailable 
bi 
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WriteThrough, 

WriteBack, 
NumberOfWritePoliciesAvailable 
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WriteAround, 

WriteAllocate, 
NumberOfWriteMissPoliciesAvailable 
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enum CacheWaitingForTypes 
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{ 

Nothing, 
CacheWaitingForReadCacheRequest, 
CacheWaitingForWriteCacheRequest, 
CacheWaitingForReadMemoryRequest, 
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CacheWaitingForFullReadBuffer, 
CacheWaitingForFullWriteBuffer, 
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MemoryBlockTransfer, 
BlockCacheAccess, 
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Seager unsigned long 
»edef unsigned long 
oedef unsigned long 
sedef unsigned long 
»edef unsigned 
aedef unsigned 
»edef unsigned 
aedef unsigned 
aedef unsigned 


int 
int 
mnt 
int 
int 
int 
nt 
int 
int 


aedef enum YesNoTypes 
aedef enum ReguestTypes 
aedef enum BlockReplacementPolicyTypes BlockReplacementPolicyType; 


TimeType; 
ScoreType; 
AddressType; 
CacheSizeType; 
SizeType; 
BufferSizeType; 
PriorityType; 
ASSOCIaCIVICtyType; 
HistogramIndexType; 


YesNoType; 
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)edef enum WriteMissPolicyTypes WriteMissPolicyType; 
»edef enum WritePolicyTypes WritePolicyType; 
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AddressType Address; 
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SizeType Block; 
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TimeType TimeToExecute; 
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MemoryRequest [10]; 
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Next; 
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CacheWaitingForType WaitingForFlag; 
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define SubBlock (Address) (( (Address) $BlockSize) /SubBlockSize) 
#define Set (Address) (( (Address) /BlockSize) $NumberOfSets) 
#define BlockAddress (Address) (( (Address) /BlockSize) *BlockSize) 
#define WordAddress (Address) (( (Address) /WordSize) *WordSize) 


#define SubBlockAddress (Address) (( (Address) /SubBlockSize) *SubBlockSize) 
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LoadArguments (); /* Page 
ScanArgument (); /* Page 
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IsRequestAHit (); 
ReadHit (); 
ReadMiss(); 
WriteHit(); 
WriteMiss(); 
AccessCache(); 
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WriteDirtySubBlocks(); 


AddToReadBuffer(); 
SearchCache(); 
AddToWriteBuffer(); 


Page 
Page 
Page 
Page 
Page 
Page 
Page 


Page 
Page 
Page 
Page 
Page 
Page 


A= 
qa 
4- 
a= 
A= 
22 
4-1 


OOD MO Œ 


4-11 
4-13 
4-14 
4-16 
4-20 
4-21 


WA 
Ww 
SA 
Se 
ZE 
WI 
a 


YA 
Ki 
WA 
" 
t 
si 


Je kk kk kk kk kk kk xk xk xk x x x x xk x x x xk xk x x x *x x x x x x x kx x x *x x xk x x x *x* x * x x * *x* * kx x *x x kx kx AAA * * *x 3% * 


SACS.h 
List of Memory.c Function Declarations 


Bscription: 


This is a list of function declarations within the file scope 


E Memory.c 


ak kk kk kk kk kk kk kk kk kk kk zk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk kk 


n void MemoryModel (); 

n void SelectMemoryRequest (); 

B void StartMemoryReads () ; 

E. void Cont inueMemoryReads (); 

B void StartMemoryWrites(); 

B void ContinueMemoryWrites(); 

BE void UpdateCache () ; 

n void AddAWordToMemoryRequest (); 

n void RemoveAWordFromMemoryRequest () ; 


pax 
/* 
/* 
/ * 
e 
/* 
T 
/* 
/* 


Page 


Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 


1- 8. 


* + 
de de 
** 
++ 
*+ o 
** 
* * 
* * 
** 


* * 


Së 


YA 
EU, 
YA 
E 
H 
YA 
di. 
2 
"> 


f CH aaa aaa He de de de aa O DR OR OR 


* de 


** 


* * 


+ + 


++ 


* Xx 


* x 


h 


** 


*o 


Description: 


This is 
of TimeEst.c 


rage 
SACS .h 


List of TimeEsSt.c Function Declarations 


a list of function declarations within the file scono 


l- 


9 


** 


+ + 


+ + 


A + 


+ + 


* * 


* À 


wx 


* + 


* * 


de ke se de e e e ke e e he de aa RARA ccc AA R 


extern void UpdateTimeToExecute(); /* Page 
extern void CalculateTimeEstimates(); /* Page 


O Á 


6— 


E 


****** Ak kk kk Ak A eoe rr rr Ak A ** * * * *x * * * 


SACS.h 


List of Get.c Function Declarations 


Description: 


MS a list of function declarations within the file scope 


EN Get .c". 


Re se kk Ak Ak kk kA kk kk kk kk kk kk kk kk kk Ak kk kk kk kk kk kk rr Ak d kk Ak ké kk A kk Ak TE TE TE TE Hr 


ern void GetNextRequest (); 


ern void 
ern void 


GetNextFileRequest (); 
GetNextKeyBoardRequest (); 


Page 


/* Page 
/* Page 
/* Page 


= TO 


7— 
7— 
7— 


3 
2 
6 


* * 
* * 
A k 
** 
A Hï 
* dr 
* * 
dd 
*o* 


* x 


ká 


*/ 
A 
YA 


f ACC aaa de de de de D Rr RS i 


Läb 


kk 


* * 


** 


** 


** Description: 


* * 


* * 


This is a list of function declarations within the file scope 


List of Display.c Function Declarations 


os 


** 


SACS.h 


Page 


1= 


** 
X X 
* x 
** 
kx 
** 
kk 
** 
** 


** 


Y H d fe e oe e d e ke kok de de de e ee ee eee e U. 


extern 
extern 
exvern 
extern 
extern 
extern 


extern 
extern 


extern 
extern 
extern 
extern 


extern 


extern 
extern 
extern 
extern 
extern 
extern 
extern 
extern 


extern 
extern 
extern 
extern 
extern 
extern 
extern 
extern 
extern 
extern 
extern 


extern 
extern 
extern 


void 
void 
vota 
void 
vola 
void 


void 
void 


void 


ScoreType 


void 
void 


void 


void 
void 
void 
void 
void 
void 
void 
void 


void 
Vola 
void 
void 
void 
void 
void 
void 
void 
Void 
void 


void 
void 
vola 


DisplayTrace(); 


DisplayCurrentRequest (); 


DisplayWaitingFors(); 
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ern void RecordRequest (); 
Brn void RecordStall(); 
ern void RecordForMatlab(); 
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/* 
/ X 
/* 
/* 
/* 
/* 
/ * 
/* 
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10382 
10- 4 
ES: 
REG 
LO 
LO 
TOS HS 
10-10 
10-2902 
10299 
10385 
10215 
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YA 


******************************** *x x x x x x e oe oe oe AAA AA AAA A kkk tkk kk kkk kk kkk kk kkk kkk 


Page e i514, +x 
SACS.h t 


kk 


uso Array ic Function Declarations Ee 


* + 


Description: * + 
* * 

This is a list of function declarations within the file scope Se 

NE "Array.c". A 


* * 


ll e E e ee e de de eee e ede de ee e e e e de e e ede e e de de AAA AR AAA AAA AAA RA AA AS 


En int *DefineArray1D(); (Ae LOS 
ma int **DefineArray2D(); /* Page 11- 4 */ 
En void FreeArraylD(); ME ATE: LI) 


rn void FreeArray2D(); /* Page ll- 6 */ 
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** 


** 


** 


* * 


*ox* 
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List of TestSACS.c Function Declarations 


WA Description: 


** 
** 


* * of 
* * 


Page 


MS 


This is a list of functronS9"cecHraratrousewibpbuznechegesuc- cone 


"TestSACS.c". 


** 
** 
* + 
* * 
+ X 
* * 
* + 
** 
** 


* * 


d d H d H H d d de K k Re e ee eee e de de de de DR OS ITI 


extern 
extern 
SKE 
extern 
extern 
extern 


void ChangeArguments(); 

void TestSACS(); 

void CreatelInstructionSets(); 
voje ShufflingInstructionSets(); 
YesNoType CanBeSwitched(); 

void WriteInstructionset (); 


/* 
J] * 
7 
E 
/* 
/* 
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1295 
L23383 
LZ 
122452 
12-14 
12543 
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YA 
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Es a list of function declarations within the file scope 
po" checking.c". 


void 
void 
void 
void 
word 
Void 
void 
void 
void 
void 
void 
void 
void 


SACS.h 


List of Checking.c Function Declarations 


Description: 


Checking(); 
CheckingConstants(); 
EmantConstError (); 
CheckingForValuesOutOfBounds(); 
ErintTimeBoundaryError(); 
EIntscoreBoundarvError(t); 
PrintSizeBoundaryError(); 
PrintEnumBoundaryError(); 
SneckingForinconsistencies (); 
£rintTotalTimeError (); 
Erint TotalScoreError (); 
CheckingPredictions(); 
PrintScorePredictionError(); 


Remo PrintTimePredictionError(); 


/* 
/* 
/* 
/* 
ZA 
/* 
/* 
/(* 
/* 
/ * 
/* 
Ji 
Vb 
pe 
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* * 


* * 


** 


** 


3 cse Wn 


e ge 
13=24 
SET 
7 
o 
ls 
lo 11 
318 
19 
Rel 
HE 
RS = 23 
13-24 
3-25 


* * 


* * 


* ok 


** 


A dr 


Fk. e de de ke e e e de e ke oko kok e ke de ke e kde oko ok de de e ke kok ok k e de de k de de k k ko kok k de de e e K e e e / 


SC 
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* * 


kk 


kk 


kk 


* * 


* * 


** 


** 


* + 


* * 


* + 


* ok 


* ok 


* * 


** 


x* 


*x o 


* * 


* + 


* + 


* * 


* * 


*o* 


** 


* * 
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* * 


SACS.C 


Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 19947 valiam Co smith 
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CA 


Permission to use, copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. 
modified version of this program should be redistributed without the 


authors consent. William G. Smith makes no warranty or 


No 


representation, promise of guarantee, either expressed or implied, 


with respect to this software's ability to produce valid results. 


This program is provided "as is" any financial, personal or property 


damage caused by the use of this program is the responsibility of the 


User- 
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kk 
kk 
kk 
* ok 
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** 
kk 
* * 
* * 
* * 
** 
Xx 
* * 
* * 
** 
** 
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SACS.C * * 

* * 

Still Another Cache Simulator * 

de + 

Description: * + 
* + 

SACS simulates ali functions one clock cycle at a time using a DI 
variable named Time. Normally it is preferred to preform timing ** 
simulations using event queues so that time can advance to the next > 
event. However, in most cache simulations so many things happen in one ** 
clock cycle that en event queue would probably not improve the * * 
preformance of the simulator * * 
* * 

In the main event loop of SACS, Time is incremented one clock WA 
cycle at a time. Time is never changed by any other procedure. e 
The requests are entered into the simulation from GetNextRequest. lini 
Simulation of all events is performed by the Main Event Loop calling WA 
CacheModel, MemoryModel, and UpdateCache. X + 


** 


The main procedure of SACS seems to call simulations in a fairly ` 
mange order. This is because SACS is insuring that all events that fo 
can be started, during a particular clock cycle are started, and that ES 


all events that can bomplete during a particular clock cycle do. It Sé 
also gives an inherent priority to the cache access events. 64 
Specifically accesses from the CPU to the cache are given higher YA 
priority that accesses from the BlockBuffer. This is why the Update = 
Cache procedure is found in three different places in the main loop. t 
Memory Model calls are found before and after the CacheModel. This = 
allows memory events that are to complete during a clock cycle to do XE 
So. The Cache Model will then have the benefit of the newly arrived EX 
data. The MemoryModel call after the CacheModel call insures that any ** 
new memory request made by the cache are started that clock cycle. Ge 
de + 

fees Main loop includes the source code to control testing, as 


checking, and tracing. The DesiredTime variable is controlled entirely ** 
by the MainEventLoop. DesiredTime represents a user request to advance ** 
ENE simulation to a particular time without the trace on. SACS can not ** 


run Time backwards. However if the Desired Time. The user can make ae 
time requests uSing arguments "G #", "#", "-#". Ge 
** 

Throughout MainEventLoop, CacheWaitingFor is checked to see if sk 

it's equal to Nothing. This indicates that the last request has been x 
serviced and that the cache is ready for the next request. The E 
procedures that model specific events as ReadHit, ReadMiss, and YA 
AccessCache are called repeatedly during their simulations they use WA 
Cache Waiting For and Time to determine what to do next. If any of EE 
these procedures needs to wait for a period either to simulate an = 
access or because a resource is not available, then they will set Cache ** 
Waiting For to the appropriate value. The modeling procedures in Ge 
Memory Model work the same way using Memory Waiting For. xor 
xt 

mi Never SACS finds an error or a discrepancy then the boolean Z^ 
variable Discrepancy Found is set to Yes. This forces SACS into a Xx 
trace mode so that the user may try to identify the cause of the error. ** 
In test mode a discrepancy forces SACS out of test mode so that the Sm 
trace file that caused the error is not erased by a new file. SCH 


** 
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** 
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de x 


* + 


* * 


* * 


* * 


* * 


** 


* * 
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de de 
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** 
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SACS.C 


Still Another Cache Simulator 


continued 


SACS.c contains the source code for main(), which contains the 


main loop. 


and file 


FOr 


For 


For 


For 


management are 
information on 
information on 
information on 


information on 


All initialization of global variables, array definitions, 


done inside "SACS.c". 

what SACS does see the User's Guide. 

how to run SACS see the User's Guide. 

how to modify SACS see the Programmer's Guide. 
how SACS works see the Programmer's Guide. 
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* x 
** 
** 
** 
* x 
** 
** 
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** 
** 
de x 
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** 
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wx 
xx 
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* de 
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#include <stdlib.h> 
#include <stdio.h> 


#include 


“SACS lh. 
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Description: 


SACS.cC 


User Defined Global Variables 


Page 


These variables represent the programs input parameters. 


23 


* k 


* X 


* * 


A + 


x + 


* * 


* * 


* * 


* * 
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heSizeType 


eType 
eType 


BciativityType 


eType 


eType 
eType 
eType 
eType 
eType 
eType 


eType 
eType 
eType 


ferSizeType 
ferSizeType 


ckReplacementPolicyType 
tePolicyType 
teMissPolicyType 


NoType 
NoType 
NoType 
NoType 
NoType 
NoType 


orityType 
ErityType 
BrityType 
REA CY T Ype 
orityType 


'NoType 
'NOType 
ToType 





NoType 
ic 


CacheSize 
BlockSize 
SubBlockSize 
ASSOCIativity 
WordSize 


ReadCacheAccessTime 
ReadCacheHitTime 
ReadCacheMissTime 
WriteCacheAccessTime 
WriteCacheHitTime 
WriteCacheMissTime 


MemoryAccessTime 
MemoryTransferTime 
BufferCacheAccessTime 


ReadBufferSize 
WriteBufferSize 


BlockReplacementPolicy 
WritePolicy 
WriteMissPolicy 


ReadForward = 
CPUWaitsForCacheWrites 
SearchBlockBuffer 
UpdateReadBuffer 
RemoveReadDuplicates 
RemoveWriteDuplicates = 


ReadPriority = 
WritePriority 
ReadForWriteAllocatePriority 
WriteDirtyBlockPriority 
HoPrrority - 


Trace 
Check 
Test = 


KeyBoardIO = 
*DataFileName = 


itogramIndexType ScreenHistogramMaxIndex 


izogramindexType FileHistogramMaxIndex 





= 8192; /* -cs 
= F6: /* -bs 
= di /* -sbs 
= 4; /* -a 
a /* -ws 
E d /* -rcat 
= 0; LEEF Ent 
= os /* -remt 
= jès /* -wcat 
= les /* —wcht 
= 0s /* —wcmt 
- 3 /* -mat 
- d /* -mtt 
= aes /* -bcat 
SÉ /* -rbs 
= a; /* -wbs 
= LRU; VE =DEp 
= WriteThrough; /* -wp 
= WriteAllocate;/* —wmp 
Yes; /* -rf —drf 
No; /* -cwfcw -dcwfcw 
Yes; ola —dsbb 
Yes; /* -urb —durb 
Yes; /* -rrd -drrd 
Yes; /* -rwd —drwd 
1; DI 
DS PSD E 
3; /* -rfwapr 
4; gu -wdbpr 
1007; -DL 
No; /*^-t =dt 
Yes; /* -c =de 
No; /* -test 
No; /* -kbio -fio 
“SACS. Dat T 
B /* -shmi 
10; /* -fhmi 
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Programmer Defined Global Variables. 


* * 


de + 


kA 


* * 


* + 
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Time Type 
TimeType 


CacheWaitingForType 
MemoryWaitingForType 
BlockWaitingForType 


YesNoType 


YesNoType 
YesNoType 
YesNoType 


Request type 
RequestType 
AddressType 


Size DĚ 
Sizelype 
TimeType 


Size pe 
SizeType 
SizeType 


AddressType 


TimeType 
SizeType 
YesNoType 
YesNoType 


TimeType 
TimeType 


TimeType 

Time iv pe 

ScoreType 
S€Omel ype 
ScoreType 
SEOBETVDE 
SGCOBETVDE 
Scone [ype 


ScoreType 
Score type 
ScoreType 


BufferType 
BufferType 
BufferType 


AddressType 


TimeType 
TimeType 
TIME Type 


FILE 
YesNoType 


Time; 
DesiredTime; 
CacheWaitingFor; 
MemoryWaitingFor; 
BlockWaitingFor; 
DiscrepancyEeund; 


CacheHit; 
BufferHito 
CacheBusy; 


Request; 
LastRequest; 
RequestAddress; 
RequestSize; 


ReguestBlockNumber; 
TimeOfNextRequest; 


NumberOfBlocks; 


NumberOfSubBlocks; 


NumberOfSets; 


*CacheBlockAddress; 


/* [NumberOfBlocks] 


*LastCacheBlockAccessTime; 


*CacheNextBlock; 
**CacheValidBit; 
~“*CacheDirtyBit; 


**RequestilineHistogram, 


P stabPrimeHiseooram; 


*TotalReguestTime; 


*TotalStallTime; 


*NumberOfAccesses; 
*NumberOfCacheHits; 
*NumberOfBufferHits; 


/* 
/* 
/* 
y x 
/* 


/* [NumberOfSets] 
/* [NumberOfBlocks] 
/* [NumberOfSubBlocks] 


/* [NumberOfRequestsAvailable] 

/* [FileHistogramMaxIndex] 
[NumberOfWaitingForsAvailable] 
[FileHistogramMaxIndex] 
[NumberOfRequestsAvailable] 
[NumberOfWaitingForsAvailable] 
[NumberOfRequestsAvailable] 


*PredictedNumberOfAccesses; 
*PredictedNumberOfHits; 


TotalNumberOfAccesses 


= 0; /* Not reset during test 


TotalNumberOfWordsReadFromMemory; 
TotalNumberOfWordsWrittenToMemory; 
TotalNumberOfWordsWrittenToCache; 


ReadBuffer; 
WriteBuffer; 
BlockBuffer; 


MAR; 
TOA; 
LOD: 
BlockTOA; 


*DataFile; 
EndOfDataFile; 


+ 


a, 
YA 
n 


oa 
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WA 
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E 





de Ye Ye oe ode oe oe oe ode ode oe oe ode oe oe oe oe oe e oe oe oe ode ode oe ode oe oe oe oe oe oe ode oe oe oe oe oe ode oe oe oe oe eoe e oe oe ode oe e oe oe oe oe oe oe %« % *% % %« *% %« A AAA Te TT DE DT * 


Bege oa t 


SACS.C ** 
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Programmer Defined Global Variables Kx 

continued ato 

* + 

BRM Or foliar nos Wa 

** 

Description: * * 


* k 


Exumerator strings are string copies of enumeration types. These ** 
are used for display purposes. YA 


* * 


RR e e ok de de de e de de K de de de Ae de de de de de de de de de de de de de de H he H H H K je de H K H de he dee dete dee deve / 


c *YesNoString[3]= 
( 


"No " E 
"Yes t j 
"Unknown" 


E fi 


| Seequestocring [NumberOfRequestsAvailable]= 
E í 


"None e" A 
| "Read ", 
| "Write" 


); 


7 *ReplacementPolicyString[NumberOfReplacementPoliciesAvailable] = 
P í 
| 1f LRU t : 
"FIFO " A 
| "RAND" 
DE 








7 *WritePolicyString[NumberOfWritePoliciesAvailable] = 


"Write Back " 
); 


< *WriteMissPolicyString [NumberOfWriteMissPoliciesAvailable) = 
{ 
"Write Around  ", 
"Write Allocate" 
hi 


{ 
uweuce Though", 
| 
| 
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* * 


*o* 


** 


* * 


*ock 


* * 


* * 


++ 


* x 


* dr 


* * 


* * 


** 


Descriptio 


n. 


Programmer Defined Global Variables 


SAGS.C 


continued 


Enumerator Strings 
continued 
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aumerator strings are string copies of enumeration types. These 
are used for display purposes. 


* * 
* k 
* + 
** 
* * 
** 
* * 
* x 
** 
* * 
* * 
* * 


* * 


dese fe fe de ce de e oe e ede ee ooo EEGEN 


char *CacheWaitingForString[NumberOfCacheWaitingForsAvailable]- 


char *MemoryWaitingForString[NumberOfMemoryWaitingForsAvailable]- 


char *BlockWaitingForString[NumberOfBlockWaitingForsAvailable]- 


d 


"Nothing 


" 
, 


"Read Cache Request  ", 
"Write Cache Request ", 
"Read Memory Request ", 
"Write Memory Request", 
"Full Read Buffer Ke 
"Full Write Buffer YA 
"CPU Cache Access È 


}; 


{ 
Nothing 
"Memory 
"Memory 
"Memory 
"Memory 
"Memory 
"Memory 


Read Request " 
Read Access 5 
Read Transfer " 


Write 
Write 
Write 


"Cache Update 


); 


{ 
"Nothing 


Reguest " 
Access " 
Transfer" 


7 


, 


, 


, 


r 


, 


T 


£ 


"Memory Block Transfer", 
"Block Cache Access H 
"Block Cache Transfer " 


); 


4 
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List of SACS Cc Function Declarations *c* 
de de 


Description: * * 
| * * 
Missa list of function declarations within the file scope A 
of IRE œH * * 
| * * 


lr e fe e ke e e de k k k k k k k k e ce de e k k e ee ee *k e k k e ee k k e % e k e ce dece *k k k k k k « *k H k % e e e ee e e e k * % % * % * e Ie] 


main (); /* Page 2- 8 */ 
i LoadArguments () ; Daga“ 2 pn] 
igned long int ScanArgument (); Lt Rage] x 
1 InitializeProgrammersGlobalVariables(); /* Page 2-15 */ 
Ñ InitializeBuffers(); EE Lor 
1 DefineArrays(); A 
i FreeArrays (); /* Page 2-18 */ 
i OpenDataFile(); Dee EE / 
1 CloseDataFile(); Ela? 
1 PauseForCommand(); f= Page 2521, */ 
Pause(); fx Pagèê. 2=234*/ 





[eR KK de k k e e ek e ke e e de de de ke o RARA AAA AA AAA RARA RAE RA RR NS RR a A A 


T Page 2-000 
= SAUS. C Nux 
* * * X 
* * main * * 
** xk 


eK KKK KKK ERE KKK KK KK RR RH MK RR RN i 


main(argc, argv) 

int arge; 

char *argvl]; 

d 

LoadArguments (argc,argv); 

if (KeyBoardIO--No || Test--Yes) OpenDataFile(); 

Time-0; 

while (Time--0 || Test--Yes) 
{ 
if (Test==Yes) ChangeArguments(); 
InitializeProgrammersGlobalVariables(); 
InitializeBuffers(); 
DefineArrays(); 


if (Test--Yes) TestSACS (PredictedNumberOfAccesses, PredictedNumberOfHits); 


RecordRequest (NumberOfRequestsAvailable); /* Reseting LastTimes */ 
RecordStall (NumberOfCacheWaitingForsAvailable); 


CheckingConstants (Yes); 
GetNextRequest (); 


CacheHit=Unknown; 
BufferHit=Unknown; 


**k**k**x*kx**kx**k* *x kx *x * x x k k x xk x x x x x x x x x x x x x x x x x x x x x x xk x x x x x x # x x x x x x x x x x Ak kk kk Ak kk kk ké kk kK 
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Main Event Loop. 


X X 


* * 


** 


* * 


** 
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while ((Request+CacheWaitingFor+MemoryWaitingFor>Nothing || 
Time<=TimeOfNextReguest) 46 
DiscrepancyFound==No & & 
Time>0 ) 
{ 


if (BlockWaitingFor==BlockCacheTransfer) UpdateCache(); 

MemoryModel (); 

CacheModel (); 

if (BlockWaitingFor==BlockCacheAccess 546 BufferCacheAccessTime==0) 
UpdateCache(); 

MemoryModel (); 


RecordRequest (Request); 

if (CacheWaitingFor==Nothing) Request=None; 
RecordRequest (Request); 

RecordStall (CacheWaitingFor) ; 


if (Time==DesiredTime) { Trace=Yes; DesiredTime=0; } 


if (CacheWaitingFor!=Nothing && 
((CPUWaitsForCacheWrites && Reguest==Write) || Reguest==Read)) 
TimeOfNextRequest-tt; 


if (Time>=TimeOfNextReguest && CacheWaitingFor==Nothing) 
{ 
GetNextRequest (); 
CacheHit=Unknown; BufferHit-Unknown; 
if (Request==None) 
{ 
if (BlockWaitingFor--BlockCacheAccess) UpdateCache(); 
Time++; 
RecordStall (CacheWaitingFor); 
RecordReguest (Reguest); 
Time--; 
ar (Check) Checking (); 
if (Trace) PauseForCommand(); 
Timett; 
) 
) 
else 


{ 
if (BlockWaitingFor==BlockCacheAccess) UpdateCache(); 


Timett; 

RecordStall(CacheWaitingFor); 

BecordRequest (Request ) ; 

Time--; 

if (Check) Checking(); 

if (Trace) PauseForCommand(); 

Time++; 

} 
if (Time>DesiredTime && DesiredTime!=0) Time=0; 
} 


f K 3 e K e dee d de e Hc dc dc Ek A a 


X X 


** 


x* 


* + 


** 


se 


End Of Main Event Loop. 
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** 
** 
* $ 
*x* 
+ + 
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if (Test--Yes && DiscrepancyFound--No) 
| 


CheckingPredictions(); 


TotalNumberOfAccesses+=NumberOfAccesses [Read] 
rNumberOfAccesses[Write]; 


) 


/*if (TotalNumberOfAccesses>=11270) (Trace=Yes; Test=No;)*/ 


1f (DiscrepancyFound==Yes) 
{ 
Pause(); 
Trace=Yes; 
Test=No; 
DesiredTime=0; 
Time=0; 
) 
if (DiscrepancyFound--No && Test--No && Time!-0) 
{ 
DisplayRequestsBreakDown(); 


RecordForMatlab(); 
} 


FreeArrays(); 


rewind(DataFile); 
EndOfDataFile=No; 


) 


if (KeyBoardIO==No) CloseDataFile(); 
return (0); 


) 


| 





| 
| 
| 


SAGS-C 


LoadArguments 


Description: 


| 


LoadArguments takes the argument list argv and changes the 


user defined global variables (See Page 2-3). 


fe e che de kk k+ k kk k k ++ k k K K X K X X X X k K kK k X X k h X X X X X X X X k X X deje kx *x*x x x x kk A 
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i LoadArguments (argc, argv) 


Int argc; 
thar *argv[]; 


Enc i, 


Br 


mee (i=l; i<argc; itt) 


{ 

D f 
DE 
DT 
ET 


nf 


DE 
á f 
PE 
if 
EE 
nef 


if 


KE 


m if 


if 


if 


emie argv[i], "-cs" 
CacheSize 
Me et=cmp (arav [i],"-bs" 
BlockSize 


Eu crcmp(argv[il,"-sbs" 
BUBBIOCkSize 

as sercmp(argv[i],"-a" 
Associativity 

(! (strcmp (argv[i],"-ws" 


WordSize 


EN EFPCOmp(argv[i],"-rcat" 
ReadCacheAccessTime 


EN -Ercmp(argv[i],"-rcht" 
ReadCacheHitTime 

au ctrcmp(argv[i],"-rcmt" 
ReadCacheMissTime 

(! (strcmp (argv[i],"-wcat" 


WriteCacheAccessTime 
auscrcmp(argv[i]l,"-wcht" 

WriteCacheHitTime 
austrcemp(argv[i],"-wcmt" 

WriteCacheMissTime 


EN strcemp(argv[i],"-mat" 
MemoryAccessTime 

EN strcmp(argv[i],"-mtt" 
MemoryTransferTime 

NN stremp(argv[i],"-bcat" 
BufferCacheAccessTime 


BN trcmp(argv[i],"-rbs" 
ReadBufferSize 
Eu scrcmp(argv[i],"-wbs" 
WriteBufferSize 


ue io 
RE CAS. 
EE 
E an 
CORRE O 


MEM: al 
A a. 
e 
E E 
o o I E 
Mic dig 


))) 
= ScanArgument (argv[++i]); 
DD 
= ScanArgument (argv(++i]); 
))) 
= ScanArgument (argv(++i]); 


DE 
= ScanArgument (argv [++i]); 
))) 
= ScanArgument (argv[++i]); 


f 8e ehe ee dee dede de "de de k ce sese dc de K ok de k eo ok ya Je oo. 


* * 


* % 


** 


* ok 


de + 


** 
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LoadArguments 
Continued 
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** 
+ k 
X 
* * 
de dk 


** 


e H e e he e de O O O O... 


qom 


ee 


deg 


(!(strcmp(argv [1], Drep ae 
{ 
BlockReplacementPolicy--1; 
for (j=0; j<NumberOfReplacementPoliciesAvailable; j++) 
{ 
if (!(stremp(argv|i|,ReplacementPolicystring|}|))) 
BlockReplacementPolicy=j; 
) 
if (BlockReplacementPolicy<0) 
{ 
printf ("Invalid Block Replacement Policy"); 
exit (1); 
) 
} 


(! (stBemp (argv (il, =wp'))) 
{ 
WritePolicy=-1; 
for (j=0; j<NumberOfWritePoliciesAvailable; j++) 
{ 
if (!(strcmp(argv[i],WritePolicyString[j]))) 
WritePolicy=j; 
) 
if (WritePolicy<0) 
1 
printf ("Invalid WritelBolicid, 
exit (1); 
) 
) 


(! (st remp (argv (1 | wm- 
{ 
WriteMissPolicy=-1; 
for (j=0; j<NumberOfWriteMissPoliciesAvailable; j++) 
{ 
if (! (stremp (argv [1),WriteMissPolieyStriino no 
WriteMissPolicy=j; 
) 
if (WriteMissPolicy<0) 
{ 
printf ("Invalid Write Miss Pole 
exit (1); 
) 


AA A A A A A A AA A A x x x xà A AAA AA AAA AA AA A AAA A K Á coke oe oe oie oie oie ode e oe oe e oe oe oe e *%« *%« *%« e e oe ode oe e de oe oe e oe che che KKK KKK 
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SACS.cC X X 

* k 

LoadArgument s Nr 
Continued * + 


** 
M oor o k e ok eoe ok e oko koe kk eee ee oe de e e e e e ee ee ee dee eoe dee ee d d de e e / 


Eum strcmp(argv[i],"-rf" 
Ew emp (argv (1],"-drf" 


ReadForward = Yes; 
ReadForward No; 


))) 
| ) D) 
| if (!(strcmp(argv[i],"-cwfcw" ))) CPUWaitsForCacheWrites = Yes; 
if (! (strcmp(argv[i],"-dcwfcw"))) CPUWaitsForCacheWrites = No; 
Iu strcmp.(argv[i],"-sbb" ))) SearchBlockBuffer = Yes; 
RNP (stremp(argv[i],"-dsbb"” ))) SearchBlockBuffer = No; 
| Eum ssrtcomp(argv[i],"-urb" ))) UpdateReadBuffer — Yes; 
| if (!(stromp(argv[i],"-durb" ))) UpdateReadBuffer = No; 
mot remp (arav (i],"-rrd" ))) RemoveReadDuplicates = Yes; 
if (!(strcmp(argv[i],"-drrd" ))) RemoveReadDuplicates = No; 
RE (strcrmp(argv[i],"-rwd" ))) RemoveWriteDuplicates = Yes; 
if (!(strcmp(argv[i],"-drwd" ))) RemoveWriteDuplicates = No; 
| merch (sercmp (argv(i],"-rpr" ))) 
| ReadPriority = ScanArgument (argv[++i]); 
meee strcmp (argv(i], "-wpr" ))) 
WritePriority = ScanArgument (argv(++i]); 
me strcmp (arav(i],"-rfwapr"))) 
ReadForWriteAllocatePriority = ScanArgument (argv(++i]); 
MEA (V (Strcmp(argv[i],"-wdbpr" ))) 
MewecDircyBlockPriority = ScanArgument (argv[++i]); 
IE srreomp(argv[i)]," "-npr" ))) 
me cDirtyBlockPriority = ScanArgument (argv [++i]); 
Be (strcemp (argv[i],"-t" ))) Trace = Yes; 
mt rcmp (argv (i],"-dt" ))) Trace = No; 
mem (strcmp (arav([i]l,"-c" ))) Check = Yes; 
M brcmp (argv(i],"-dc" ))) Check = No; 
mt rcmp (argv([i],"-test" ))) Test = Yes; 
st remp (argv|i),"-kbio" ))) KeyBoardIO = Yes; 
m strcmp(argv(i],"-fio“ ))) KeyBoardIO = No; 
eis cmp(argv[i],"-£f" ))) DataFileName = argv[++i]; 


e iseremp(argv[i],"-shmi" ))) 

ScreenHistogramMaxIndex = ScanArgument (argv [++1]); 
Ix strcmp(argv[i],"-fhmi" ))) 

FileHistogramMaxIndex = ScanArgument (argv(++i]); 


f| Ne ee dee ee e he e e e e de de de ER 


* ok 


* + 


* Ak 


* Á 


** 


** 


x * 


* + 


* * 


* ok 
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ScanArgument 
Description: 


ScanArgument scans the input string for an unsigned long int, 
if one is not found an error is raised. 


Z- ld 


* * 


** 


* * 


*ock 


** 


xk 


* + 


** 


* * 


* * 


ak AA eee 


unsigned long int ScanArgument (Argument) 


char *Argument; 


unsigned long int Temp; 


if (sscanf (Argument, "3U", &Temp) !=1) 
{ 
printf("Error unsigned integer expected [$s].",Argument); 


je 


return (Temp); 



















escription: 


„cheWaitingFor 
moryWaitingFor 
„ockWaitingFor 
.ScrepancyFound 


iquest 

IstRequest 

Ouest Address 
questBlockNumber 
EmestSize 
questBlockNumber 
meOfNextRequest 


mberOfBlocks 


mberOfSubBlocks 
mberOfSets 


adsLeftForBlock 


‘itesLeftForBlock 


A 
D 
ockTOA 


dOfDataFile 


talNumberOfWordsReadFromMemory 
talNumberOfWordsWrittenToMemory 
talNumberOfWordsWrittenToCache 


adsLeftForRequest 


itesLeftForRequest 


Page 
SACSHE 


InitializeProgrammersGlobalVariables 


InitializeProgrammersGlobalVariables takes the user defined global 
'ariables and calculates programmer defined global variables, 
'onstant, once the input paramaters are determined, and reinitializes 
he global variables what will change. 


InitializeProgrammersGlobalVariables () 


L; 


Nothing; 
Nothing; 
Nothing; 
No; 


Unknown; 
Unknown; 


= No; 


None; 
None; 


CacheSize/BlockSize; 
BlockSize/SubBlockSize; 


= NumberOfBlocks/Associativity; 


0; 
0; 
0; 


which are 


AAA AAA AAA AAA AA AA AAA A AAA AAA AA ACI AAA A AA AAA AAA AA AAA AA AAA A A à H de ode oe ode ode oe oe oe oe oe oe oe *%« e *% 


* * 


* ye 


* * 


* X 


* + 


de de 


** 


** 


x* 


* ok 


** 


** 


MEE oe eo ook oo oe ye e eoe e e E e Ee E E de de d d de e dee dee de de de he eode d je de H d H n € / 


fode de de de ke de de k de de de de de de de de k l kl 


** 


* + 


x* 


* + 


x* 


de * 


** 


de de 


* * 


* x 


Description: 


InitializeBuffers places the buffers in an empty state, with 


SACS.C 


InitializeBuffers 


their Maz values set to the appropriate size. 


Page 


235 


* * 
* * 
x* 
* o 
*% 
kk 
* * 
*oc* 
x* 


** 


e e de e e e ko te te ee te ete ee eR RR OD aa aaa ai HW Wa AAA R C 


void InitializeBuffers() 


{ 


ReadBuffer.Full 
ReadBuffer.Empty 
ReadBuffer.Next 


WriteBuffer 
BlockBuffer 


ReadBuffer.Max 
WriteBuffer.Max 
BlockBuffer.Max 


= No; 


Yes; 
0; 


= ReadBuffer; 


ReadBuffer; 


= ReadBufferSize-1; 


WriteBufferSize-1; 
0; 


ReadBuffer.WaitingForFlag = CacheWaitingForFullReadBuffer; 


WriteBuffer.WaitingForFlag 
BlockBuffer.WaitingForFlag 


) 


CacheWaitingForFullWriteBuffer; 
Nothing; 






i DefineArrays () 


eee cress 


| 


| 
BENE. eerie 


| 


| 
"acheNextBlock 


zacheValidBit 


‘acheDirtyBit 


| 


: 
teguestTimeHistogram 
itallTimeHistogram 


7otalRequestTime 
‘otalStallTime 
JumberOfAccesses 


TumberOfCacheHits 


lumberOfBufferHits 


'redictedNumberOfAccesses 


1 


| 
'redictedNumberOfHits 


| 


I 


p de d de d d e de de de He de d de He he dede de e e LARA 
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SACS.C * * 

Xx 

DefineArrays * * 

kx 

Description: ded 
| * ok 
DefineArrays assigns memory to the array pointers. * * 


d+ 


Ik dk ok ok e Kk de de de de de de kk Ke RARA RARA ARARAS RADAR RAR RARA / 


(AddressType*) 

DefineArraylD (NumberOfBlocks, 
sizeof (AddressType)); 

(TimeType*) 

DefineArraylD (NumberOfBlocks, 
sizeof (TimeType) ); 

(SizeType*) 

DefineArraylD (NumberOfSets, 
sizeof (SizeType)); 

(YesNoType**) 

DefineArray2D (NumberOfBlocks, 
NumberOfSubBlocks, 
sizeof (YesNoType)); 

(YesNoType**) 

DefineArray2D (NumberOfBlocks, 
NumberOfSubBlocks, 
sizeof (YesNoType)); 

(TimeType**) 

DefineArray2D (NumberOfRequestsAvailable, 
FileHistogramMaxIndex, 
sizeof (TimeType)); 

(TimeType**) 

DefineArray2D (NumberOfCacheWaitingForsAvailable, 
FileHistogramMaxIndex, 
sizeof(TimeType)); 

(TimeType*) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (TimeType)); 

(TimeType*) 

DefineArraylD (NumberOfCacheWaitingForsAvailable, 
sizeof(TimeType)); 

(ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType)); 

(ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof(ScoreType)); 

= (ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType)); 

(ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType)); 

(ScoreType* ) 

DefineArraylD (NumberOfRequestsAvailable, 
sizeof (ScoreType)); 


/ Kk k k k k % % % % % % % k X XX X XX XX XX XX XX XXX XXX XXX XX XXX XXX XX X X e e kc k k Ok OK % k k k k k k k X X Kk A e 


* t 


** 


* * 


* * 


* X 


* * 


* * 


* x 


** 


* * 
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EreeArrays 


Description: 


FreeArrays deallocates the memory assigned to the array points 


by DefineArrays. 


* * 


** 


** 


* * 


* * 


* + 


* *x 


* * 


* * 


* * 


eoe dede cde cde d H dede e e e H H de H ec ek E de K KOROKOROR KO x Ex eee 


void FreeArrays() 


d 


char c; 


FreeArraylD (CacheBlockAddress, 
FreeArraylD (LastCacheBlockAccessTime, 
FreeArraylD (CacheNextBlock, 
FreeArray2D (CacheValidBit, 
FreeArray2D(CacheDirtyBit, 


FreeArray2D (RequestTimeHistogram, 
FreeArray2D (StallTimeHistogram, 
FreeArraylD (TotalReguestTime, 
FreeArraylD (TotalStallTime, 
FreeArraylD (NumberOfAccesses, 
FreeArraylD (NumberOfCacheHits, 
FreeArraylD (NumberOfBufferHits, 
FreeArraylD (PredictedNumberOfAccesses, 


FreeArraylD (PredictedNumberOfHits, 


) 


NumberOfBlocks); 

NumberOfBlocks); 

NumberOfSets); 

NumberOfBlocks, NumberOfSubBlocks) 
NumberOfBlocks, NumberOfSubBlocks) 


NumberOfRequestsAvailable, 
FileHistogramMaxIndex); 
NumberOfCacheWaitingForsAvailable, 
FileHistogramMaxIndex); 


NumberOfRequestsAvailable); 
NumberOfCacheWaitingForsAvailable) 


NumberOfRequestsAvailable); 
NumberOfRequestsAvailable); 
NumberOfRequestsAvailable); 
NumberOfRequestsAvailable); 


NumberOfRequestsAvailable); 


, 


, 


e 
, 
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SAGES. Cc * * 

+ + 

OpenDataFile * * 

+ 

)escription: * * 
| + 
| OpenDataFile opens the file specified by DataFileName for ** 
reading. This becomes the data file that GetNextFileRequest reads ** 


"rom. x 
| * * 


Ke e fe e e e e e e e kH k e kà) e x kX e X e x e x H k k x à xX x à x E H X x e de à % x k k x x k x k à H % k e * k e e c e e A e * / 


OpenDataFile() 


(Test==No) 

{ 

if ((DataFile=fopen (DataFileName, "r") )==NULL) 
{ 
printf("Cannot open $s file",DataFileName); 
exit (0); 
} 





} 


SE 


{ 

if ((DataFile=fopen (DataFileName, "w+") )==NULL) 
{ 
printf("Cannot open %s file”, DataFileName) ; 
exit (0); 
) 


©) 
(Í 


f Hee dede dece de dede dece e e e d de e Sec ke c e e eh kk e e R 


* x 


A de 


A A 


* * 


*x * 


* * 


A + 


xk 


xk* 
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CloseDataFile 
Description: 


CloseDataFile closes the data file that OpenDataFile opened. 


2D 


A de 


* Xx 


* * 


* Xx 


** 


* * 


A + 


X X 


** 


*k H * AAEE LEER 


void CloseDataFile() 


fclose(DataFile); 
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PauseForCommand 
Description: 
PauseForCommand controles the displays. It takes input for the 


‘keyboard to determan which display to provide. It also adjusts the 
global variable Desired Time based on "#", "-#", and "G #" commands. 


l PauseForCommand () 


static char LastDisplayMode=" "; 


EnmnpStrrzngPt, 
CommandChar, 
DisplayMode-' "; 


E EnputString[255], 





mt Index; 
E re TmpTime; 


Lf (Trace--Yes) LastDisplayMode-'t'; else LastDisplayMode-'r'; 


mile (DisplayMode!-LastDisplayMode) 


i { 


if (DisplayMode!=’ ’) LastDisplayMode=DisplayMode; 
DisplayMode=LastDisplayMode; 

if (LastDisplayMode--'t') DisplayTrace(); 

if (LastDisplayMode--'r') DisplayRequestsBreakDown(); 
if (LastDisplayMode--'s') DisplayStallHistogram(); 
if (LastDisplayMode--'c') DisplayCacheArguments (); 
if (LastDisplayMode==’h’) DisplayHelp(); 


printf("\nNext Command Please [ T, R, S, C, G #, #, -#, Help] >>>"); 


Index=-1; 
do 


{ 
Index++; 


scanf("%c", &InputString [Index] ); 
} 
while (InputString [Index] !=’ \n’ ); 


while (InputString[0]==" ') 
for (Index=0; InputStringiIndex]!=' in”; Index++) 
Input String [Index]=InputString[Index+1]; 
| CommandChar=InputString(0)}; 


i if (CommandChar>=’A’ && CommandChar<=’ Z’) CommandChar*-('a'-'A'); 


| e 


t dr ce e e H H xk x+ x * x kx x x x kx ode ode ode de oe ode oe ode ode ode ode de de ode de de de ode de ode de de de ode de de ode ode e ode de ode ode de de ode oe de ode de dde oe e e de de de se de de de e ode e ode e ode oe 


** 


* * 


de de 


kk 


*« *x 


de de 


kk 


de dr 


kk 


* de 


* * 


EEUU l x ko Yo oko dede eode eode de de tee e de dede rhe de rr A 


PAA L R 


** 


X X 


** 


kk 


* + 


A + 


So. E 


PauseForCommand 
continued 
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kk 


* * 


* * 


* x 


Ae de 
> 


* * 


a OR eee 


if (sscanf(InputString, "3U", &TmpTime)==1 && CommandChar!=’ \n’ ) 


ae 


E 


If 
TE 
Le 
T 
LE 
SE 


{ 
DesiredTime=Time+TmpTime; 
Trace=No; 

) 


(CommandChar==’ —’ ) 

{ 

TmpStringPt=Input String, 

ImPSELINGPE RA. 

if (sscanf (TmpStringPt, "$U", &TmpTime) ==1) 
Trace=No; 

} 


(CommandChar=='q' ) 

{ 

TmpStringPt=Inputsteelng, 

ImPpSEtrINgeL 

if (sscanf (TmpStringPt, "%U", &TmpTime) ==1) 
Trace=No; 

} 


(CommandChar==’ 
(CommandChar==’ 
(CommandChar==’ 


t DisplayMode=’ t’ 

É 

S 
(CommandChar==’ c’ 

h 

q 


DisplayMode-'r'; 
DisplayMode-'s'; 
DisplayMode-'c' 
DisplayMode-'nh'; 
exit (0); 


"me 


mo 


(CommandChar==’ 
(CommandChar==’ 


DesiredTime-Time-TmpTime; 


DesiredTime-TmpTime; 


dede d de de KAAA 
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* * 
Pause ** 


* + 


Description: + + 
de de 


| Lung for a character to be entered in. * + 
| + + 


s Sk e e e e e e e e e e e ke e Àe He e e ee e e e e ede e ee e e e e e e e e e de e e e e e e e e e de e e e ke ke ke ke ke ke e e ee ke e e e y 


. Pause () 


rintf("\nHit the return key to Continue:"); 


har InputCharacter; 





O 


{ 
mne SC”, é InputCharacter); 


) 


ile (InputCharacter!=’ \n’); 


ett S 


. 
= - 





iii % Ok Kk kk Ok ok KK OK K d KO Ok Ok ck kk Ck Kk Ck Ck k k % % k k k k k í * CK ko k ck ck k ck ck k k Ck k K k ck k k ck KC RR RA X 


xk 


* * 


* * 


x* 


x* 


* * 


* * 


** 


x* 


** 


* * 


X + 


** 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


x* 


** 


de k 
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Parit OT Sato 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies ls 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or Impre 
with respect to this software's ability to produce valid results- 
This program is provided "as is" any financial, personal or propesa, 
damage caused by the use of this program is the responsibility of the 
user. 


* * 


de + 


* X 


* * 


* * 


* * 


* X 


x* 


kx 


de de 


* + 


* * 


* * 


* * 


* * 


** 


** 


* x 


* o 


* X 


* * 


* x 


* * 


* * 


** 


* ck 


* * 
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Global.h * * 

* ok 

Global Variables Used by SACS Packages x 

wx 

Description: aoe 


** 
| 


| BENGbal-h is the only include file needed by all of the SACS source ** 
miles. contains all the global variables, both user and programmer ** 
defined variables. The user defined variables Repre scan NE input a 
arameters. The programmer defined variables represent all global RE 
Nes that are shared between all the SACS source code files, that ** 
-he user does not have access to. We 

Lä + 
defines all of the initial values of the global variables EC 
therefore, does not include Global.h +s 


x* 











Fable dor Contents GE 

** 

MMC... Se Page 3-1 Nut 
RE Defined Global Variables ............. Page — 02 * t 
Programmer Defined Global Variables ....... Page 5-03 Zéi 


*o* 


EE sic ic sic sik se se Se e e e e d d H e e e ee e H e e e e e e H H de e e d d d d d À e À d d e H e e je e e e e e c e e e e e e e e e e ee e / 


lef GLOBAL.H 
„ne © GLOBAL.H 


-ude <stdlib.h> 
-ude <stdio.h> 


mide "SACS.h" 


fk kk kk e ee e x k k x x x kx x k x x x x x x x x x x x x kx x x x e ede kx x x x e eee e ede DA A + k+ k k+ k 


* * 


A + 


* + 


* + 


Global.h 


User Defined Global Variables 


** .— Description 


* + 


* + 


* * 


Page 


These variables represent the programs input parameters. 


352 


* + 
* * 
X + 
** 
** 
xx 
** 


* * 


WR IO OL ER DEM LEM 


extern 
extern 
extern 
extern 
extern 


extern 
extern 
extern 
extern 
extern 
extern 


extern 
extern 
extern 


extern 
extern 


extern 
extern 
extern 


extern 
extern 
extern 
extern 
extern 
extern 


extern 
extern 
extern 
extern 
extern 


extern 
extern 
extern 


extern 
extern 


extern 
ext ern 


CacheSizeType 
SizeType 

SizeType 
AssociativityType 
SIZEIVDS 


TimeType 
TimeType 
Time hype 
Timetype 
TimeType 
Time pa 


TimeType 
Tamed ype 
TimeType 


BufferSizeType 
BufferSizeType 


BlockReplacementPolicyType 
WritePolicyType 
WriteMissPolicyType 


YesNoType 
YesNoType 
YesNoType 
YesNoType 
YesNoType 
resNoType 


PriorityType 
PriorityType 
PriorityType 
PriorityType 
PriorityType 


YesNoType 
YesNoType 
YesNoType 


YesNoType 
char 


HistogramindexType 
HistogramindexType 


CacheSize; 
BlockSize; 
SubblockSize; 
Associativity; 
WordSize; 


ReadCacheAccessTime; 
ReadCacheHitTime; 
ReadCacheMissTime; 
WriteCacheAccessTime; 
WriteCacheHitTime; 
WriteCacheMissTime; 


MemoryAccessTime; 
MemoryTransferTime; 
BufferCacheAccessTime; 


ReadBufferSize; 
WriteBufferSize; 


BlockReplacementPolicy; 
WEAterolicy; 
WriteMissPolicy; 


ReadForward; 
CPUWaitsForCacheWrites; 
SearchBlockBuffer; 
UpdateReadBuffer; 
RemoveReadDuplicates; 
RemoveWriteDuplicates; 


ReadPriority; 

WritePriority; 
ReadForWriteAllocatePriority; 
WriteDirtyBlockPrioritey; 
NọPriority; 


Trace; 
Check; 
Test; 


KeyBoardIO; 
*DataFileName; 


ScreenHistogramMaxIndex; 
FileHistogramMaxIndex; 
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Global.n => 

* + 

Programmer Defined Global Variables ui 


** 
ll e E e de He X X X e Rok E e e de kk de e e e e e e e de de de de e e ee dee ee dee / 


rn TimeType Time; 

En TimeType DesiredTime; 

E» CacheWaitingForType  CacheWaitingFor; 
rn MemoryWaitingForType MemoryWaitingFor; 
rn BlockWaitingForType BlockWaitingFor; 


En YesNoType Disecrcpancyvl ound, 
rn YesNoType CacheHit; 
rn YesNoType BufferHit,; 
rn YesNoType CacheBusy; 


rn RequestType Request; 
BequestIype LastRequest; 
AddressType ReguestAddress; 


— AD anão AA K K K K K K HH 
Se? 


mm SizeTyve RequestSize; 

rn SizeType ReguestBlockNumber; 

rn TimeType TimeOfNextRequest; 

In SizeType NumberOfBlocks; 

rn SizeType NumberOfSubBlocks; 

rn SizeType NumberOfSets; 

E AddressType  *CacheBlockAddress; /* [NumberOfBlocks] * / 

En TimeType *LastCacheBlockAccessTime; 

xn ENZeType BeocbeNextBlock; /* [NumberOfSets] f 

im YesNoType **CacheValidBit; /* {NumberOfBlocks] 3 / 

rn YesNoType **CacheDirtyBit; /* [NumberOfSubBlocks] Sá 

rn lame Type **RequestTimeHistogram; /* [NumberOfRequestsAvailable] */ 

| /* [FileHistgramMaxIndex] s 

irn TimeType mota lWTimeHistogram; /* [NumberOfCacheWaitingForsAv]*/ 
/* [FileHistgramMaxIndex] si 

irn TimeType *TotalRequestTime; /* [NumberOfRequestsAvailable] */ 

irn Ime Type eta lsStallTime; /* [NumberOfStallsAvailable] i 

irn ScoreType *NumberOfAccesses; /* [NumberOfRequestsAvailable] */ 

irn ScoreType *NumberOfCacheHits; 

rn EcoreType *NumberOfBufferHits; 

ED ScoreType EPredictedNumberOfAccesses; 

irn ScoreType *PredictedNumberOfHits; 

EN ScoreType EcedunberOFACCesses; 

In ScoreType TotalNumberOfWordsReadFromMemory; 

¿In ScoreType TotalNumberOfWordsWrittenToMemory; 

En ScoreType Woroilliumber0fWordsWrittenToCache; 

gen BufferType ReagBurter; 

gen BufferType WritceBuffer; 

CH EntferType BlockBuffer; 

rn AddressType MAR; 

En TimeType TOA; 

řrn TimeType TOD; 

Ern TimeType BlockTOA; 


en FILE *DataFile; 
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Programer Defined Global Variables 
continued 
Enumerator Strings 


** 


** 


* * 


** 


* + 


* * 


* * 


PARRA A AAA ALLER, 


extern char 


*YesNoString[], 
*RequestString[], 
*ReplacementPolicyString[], 
*WritePolicyString[], 
*WriteMissPolicyString[], 


*CacheWaitingForString[], 
*MemoryWaitingForString[l, 
*BlockWaitingForString[]; 


#endif 


/* 
/* 
/* 


/* 
/* 


/* 
/* 


[2] 

[NumberOfRequestsAvailable] 
(Replacement PomwrevSst ring) 
[(NumberOfWritePoliciesAvailable] 
[NumberOfWriteMi:.PoliciesAvailable] 


[NumberOfCacheWaitingForsAvailable] 
[NumberOfMemoryWaitingForsAvailable] 
[NumberOfBlockWaitingForsAvailable] 
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Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/11/94 


Menor: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
EE Uided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
MEC respect to this software's ability to produce valid results. 
Saas program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user. 
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Description: 
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CacheModel makes all the necessary calls to Simulate cache memory. 
CacheModel decides which calls to make, based on the value of CacheHit, 
and Request. This function is called every time Time is incremented. 
If there are no read or write requests waiting to be completed the 


function does nothing. 


The value of CacheHit will remain Unknown until 


the appropriate cache access time has expired. Then CacheModel will 
call IsRequestAHit to determine if the request is a hit or a miss. 
Table of Contents 
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#include "Global.h" 
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Cache.c * x 

* *% 

List of Cache.c Function Declarations o 

* * 

jescription: de de 
de * 

| mes. a list of function declarations within the file scope ft 
EN Ssche.c". + + 


** 
l e e e RE RR RR RE ARRE kk 


CacheModel (); pe Page 22597 
IsRequestAHit (); La Pago” SPA AI 
ReadHit (); /* Page 4- 5 */ 
ReadMiss(); /* Page 4- 6 */ 
WriteHit (); /* Page 4- 7 */ 
WriteMiss(); /* Page 4- 8 */ 
AccessCache(); /* Page 4-10 */ 

SelectBlockVictim(); /* Page 4-11 */ 

ESUDYrtyBits (0; /* Page 4-13 */ 

WriteDirtySubBlocks(); /* Page 4-14 */ 

AddToReadBuffer (); /* Page 4-16 */ 

Type SÞ srenCache () ; /* Page 4-20 */ 


AddToWriteBuffer(); /* Page 4-21 */ 
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Description: 


CacheModel makes all the necessary calls to simulate cache memory. 
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Cache.c 


CacheModel 


CacheModel decides which calls to make, based on the value of CacheHit, 


and Request. 


This function is called every time Time is incremented. 


If there are no read or write requests waiting to be completed the 


function does nothing. 


The value of CacheHit will remain Unknown until 


the appropriate cache access time has expired. Then CacheModel will 
call IsRequestAHit to determine if the request is a hit or a miss. 


* + 


** 


** 


* + 


** 


* X 
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* * 


** 


kk 
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void CacheModel () 


{ 


if 


if 
LE 
IE 
CE 


(CacheHit==Unknown && Request!=None) 


{ 


if (Reguest==Read ) 
AccessCache (ReadCacheAccessTime, CacheWaitingForReadCacheRequest); 
if (Request--Write) 


AccessCache (WriteCacheAccessTime,CacheWaitingForWriteCacheRequest); 


if (CacheWaitingFor==Nothing) IsRequestAHit (); 


} 


(CacheHit==Yes 
(CacheHit==No 
(CacheHit==Yes 
(CacheHit==No 


66 Request--Read ) 
&& Request--Read ) 
&& Request--Write) 
&& Request--Write) 


ReadHit (); 
ReadMiss(); 
WriteHit(); 
WriteMiss(); 


= Hi 
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IsSRequestAHit 


NSCription: 








| IsRequestAHit determines if the request is a hit or a miss, and 
ets CacheHit to the appropriate value. IsRequestAHit will find the 
jetNumber that the data is supposed to be in. Then all 
'acheBlockAddresses in that set will be checked to see if they equal 
he BlockAddress for that request. If the correct block is found, 
hen all sub blocks that are required to satisfy the request will be 
Npected for validity. If all required sub blocks are valid then 
'acheHit will equal Yes on return from IsRequestAHit. 


IsRequestAHit () 





zeType SetNumber 
'zeType rs Block 
zeType Last Block 
zeType puockIndex; 
IzeType EubBlockIndex; 


Set (RequestAddress); 
SetNumber*Associativity; 
EIIStBIOCKTASSOCIatiViIty-l; 


A 


cheHit=No; 
fferHit=Unknown; 


Ir (BlockIndex=FirstBlock; BlockIndex<=LastBlock; BlockIndex++) 
{ 


| if (CacheBlockAddress [BlockIndex]--BlockAddress (RequestAddress)) 
{ 
CacheHit=Yes; 
1f (Reguest==Read) 
{ 
for (SubBlockIndex=SubBlock (ReguestAddress); 
SubBlockIndex<=SubBlock (RequestAddress+RequestSize-1); 
SubBlockIndex++) 


de ode 


x* 


de de 


x* 


x* 


* + 


x* 


* * 


* + 


* * 


+ x 


** 


* * 


A de 


* e 


A de 


A 


if (CacheValidBit[BlockIndex][SubBlockIndex]-zNo) CacheHit=No; 


) 
LastCacheBlockAccessTime [BlockIndex]=Time; 


} 
) 


| 


| 

| (CacheHit==Yes) BufferHit=No; 
) 

| 

j 





f oh dede de dede dede e de e dee nde e aa EE O 


* de 


* de 


dd 


A + 
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dd 
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*o* 


* * 


Page 4- 5 
Cache.c 


ReadHit 
Description: 


ReadHit is called to simulate a cache hit during a read request. 
Read Hit simply finishes simulating the cache access for the hit. 
ReadCachHitTime is the time required to send the data from the cache 
to the CPU. Note that the Ttime to locate the block in the cache is 
simulated in CacheModel.  ReadHit is called repeatedly while Time is 
incremented until Access Cache returns with CacheWaitingFor equal to 
Nothing.  AccessCache will return CacheWaitingFor equal to 
ReadCacheRequest until the ReadCacheHitTime has expired. 


de de 
de + 
de de 
de de 
* de 
de de 
de de 
* + 
de de 
* k 
* k 
** 
A de 
de de 
de de 


de de 


dede *% d Y H H d CM A AA AA S 


void ReadHit () 


{ 


AccessCache (ReadCacheHit Time, CacheWaitingForReadCacheRequest) ; 


} 
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de de 

ReadMiss SÉ 

| 7 *x * 
Description: 


de de 

ReadMiss is called to simulate a cache miss during a read request. ** 
ReadMi ss first simulates the time it would take to perform all block udo 
management for a read miss. This time is called Read Cache Miss Time.  ** 
Dnce that time has passed Read Miss calls Select Block Victim to pick a ** 
9lock in the set. When SelectBlockVictim returns with CacheWaitingFor  ** 
squal to Nothing the Request Block Number will contain the new block 2 
aumber where the data will be placed. ** 
H de de 
| Once the new block has been chosen, ReadMiss will call X 
AddToReadBuffer. If ReadForward is selected, then RequiredSize for the ** 
RE request will be equal BlockSize. The RequiredSize in the read WA 





memory reauest tells the MemoryModel how much of the requested data DES 
nust be read into the BlockBuffer before resetting Cache WaitingFor x 
Back to Nothing. By setting RequiredSize equal to BlockSize, Read Miss ** 
EN cung Memory Model to read in the entire block before setting Se 
-ache aating For back to Nothing. Once the Memory Model has read in bx 


EE" it is assumed to be able to the CPU during that clock cycle. ** 
* $ 
Red de e se e K k e e e K 3 *% e de e e H e K K H K k e e e e e e e ee de e e H K *% e H H H d H K *% H *% *% d H H H K kikki / 


. ReadMiss () 


scessCache (ReadCacheMissTime, CacheWaitingForReadCacheRequest); 


É (CacheWaitingFor==Nothing || 
CacheWaitingFor--CacheWaitingForFullWriteBuffer) 
SelectBlockVictim(); 


£ (CacheWaitingFor==Nothing || 
CacheWaitingFor--CacheWaitingForFullReadBuffer) 
{ 
if (ReadForward==Yes) 
AddToReadBuffer (RequestAddress, 
BlockSize, 
RequestSize, 
RequestBlockNumber, 
ReadPriority); 
else 
AddToReadBuffer (RequestAddress, 
BlockSize, 
BIOCkSrze, 
RequestBlockNumber, 
ReadPriority); 
if (CacheWaitingFor--Nothing) 
CacheWaitingFor-CacheWaitingForReadMemoryRequest; 
} 


2cordStall(CacheWaitingFor); 

* (CacheWaitingFor==CacheWait ingForReadMemoryRequest 868 
Y NoRequestsLeft (&ReadBuffer) ) 

! CacheWaitingFor-Nothing; 
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* * 
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de de 
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* + 

WriteHit > 

* * 

Description: A + 


** 


WriteHit is called to Simulate a cache hit during a write reguest. ** 


Write Hit will first simulate the time to write the data to the WA 
ReguestBlockNumber in the cache. Note that the time tc locate the xs 
block was simulated by CacheModel. Once WriteCacheHitTime has expired  ** 
then WriteHit will perform the block management for the request. The E" 
block management is dictated by the WritePolicy. For a WriteBack SH 
policy the sub blocks written to must have their dirty bits Set D ee 
is done by SetDirtyBit. For a WriteThrough policy the reguest mustcib em- 
set to the write buffer. This is done by AddToWriteBuffer. e? 


de de 


de e de de e e e de d e ee RK EEK KNEE KEE EKA ERE ER eA ER SR N Y H 


void WriteHit () 


{ 


AddressType TempAddress; 


AccessCache (WriteCacheHitTime, CacheWaitingForWriteCacheRequest) ; 


stig 


(CacheWaitingFor==Nothing || 


d 


CacheWaitingFor==CacheWaitingForFullWriteBuffer) 


switch (WritePolicy) 


{ 
case WriteBack: 
{ 
SetDirtyBits (); 
break; 
} 
Case Write Thronaho 
{ 
for (TempAddress =SubBlockAddress (RequestAddress+SubBlockSize-1); 
TempAddress <SubBlockAddress (RequestAddress+RequestSize); 
TempAddress+=SubBlockSize) 

CacheValidBit [RequestBlockNumber] [SubBlock (TempAddress) ]=Yes; 
AddToWriteBuffer (RequestAddress,RequestSize,WritePriority); 
break; 

) 

default: 
printf("WritePolicy not defined for [WriteHit] procedure. "5; 
exit (1); 
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WriteMiss 


Description: 
| REMISS is called to simulate a cache miss during a write 
equest. WriteMiss will first simulate the time needed to perform 
hii block management reguests. The time is called WriteCacheMissTime. 
'his is only the time reguired to make the reguests, not the time 
'equired to complete the block management requests. The time to 
letermine that a miss occurred was simulated by CacheModel. Once the 
EEEeCacheMissTime has expired, then WriteMiss will perform all block 
Aanagement requests. The memory requests are dictated by the 
JriteMissPolicy. The simplest policy is WriteAround. For a 
EmPteAround policy the write data is placed in the WriteBuffer by 
iddToWriteBuffer. WriteAllocate however, is the toughest simulation 
„n BROS) WriteMiss must first choose a block to put the new data in. 
‘his EsEdone by SelectBlockVictim. Then the block data not provided 
)y the write has to be read in. This read request is made by 
\ddToReadBuffer . Because the read address is calculated by adding the 
request size to the address. The new address may be in the next block 


io to make the addition modulo the BlockSize may have to be subtracted. 


Then the read request has been make then the sub blocks that were 

co in there entirety will have there valid bits set. If only 
art of a sub block was written to then the CacheValidBit will not be 
j| 


WriteMiss then uses the WritePolicy to dictate how the write data 
sto update the memory. For a WriteBack policy dirty bits are set by 
letDirtyBits. For a WriteThough the data is added to the WriteBuffer 
uAddToWriteBuffer. 
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(© WriteMiss() 


ildressType TempAddress; 
bcessCache(WriteCacheMissTime, CacheWaitingForWriteCacheRequest); 


Match (WriteMissPolicy) 
1 


case WriteAround: 
{ 
if (CacheWaitingFor==Nothing || 
CacheWaitingFor--CacheWaitingForFullWriteBuffer) 
AddToWriteBuffer(RequestAddress, RequestSize, WritePriority); 
break; 
) 


Befault: 
{ 
mint ("WriteMissPolicy not defined in [WriteMiss] procedure"); 
Et (1); 
) 
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** 

WriteMiss * * 
continued * * 


** 
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case WriteAllocate: 
{ 


if (CacheWaitingFor==Nothing || 
CacheWaitingFor==CacheWaitingForFullWriteBuffer) 
SelectBlockVictim(); 


if (CacheWaitingFor==Nothing || 
CacheWaitingFor==CacheWaitingForFullReadBuffer) 
{ 
if ((BlockSize-ReguestSize)>0) 
if (BlockAddress (RequestAddress+RequestSize) 
==BlockAddress (RequestAddress)) 
AddToReadBuffer (RequestAddress+RequestSize, 
BlockSize-ReguestSize, 
0, 
ReguestBlockNumber, 
ReadForWriteAllocatePriority); 
else 
AddToReadBuffer ( (RequestAddress+RequestSize)-BlockSize, 
BlockSize-ReguestSize, 
0, 
ReguestBlockNumber, 
ReadForWriteAllocatePriority); 
| 


if ((CacheWaitingFor--Nothing || 
CacheWaitingFor--CacheWaitingForFullWriteBuffer) && 
CacheBlockAddress [RequestBlockNumber]==BlockAddress (RequestAddress) ) 
{ 


for (TempAddress =SubBlockAddress (RequestAddress+SubBlockSize-1); 
TempAddress <SubBlockAddress (RequestAddress+RequestSize); 
TempAddress+=SubBlockSize) 
CacheValidBit [RequestBlockNumber] [SubBlock (TempAddress) ]=Yes; 


switch (WritePolicy) 

{ 

case WriteBack: 
SetDirtvVBits(), 
break; 

case WriteThrough: 
AddToWriteBuffer(RequestAddress, RequestSize, WritePriority); 
break; 

default: 
printf("WritePolicy not defined for [WriteMiss] procedure"); 
exit (1); 


break; 
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AccessCache 
EScription: 


AccessCache is called to simulate a the CPU accessing the cache. 
iccessCache first waits for the cache not to be busy. The only reason 
tt could be busy is if the BlockBuffer is in the process of updating 
'he cache. During this time AccessCache will return CacheWaitingFor 
iqual to CPUCacheAccess. Once the cache is not busy then CacheBusy is 
set to Yes locking out the BlockBuffer from accessing the cache. Then 
tacheWaitingFor will set equal to WaitingForRequest this is a local 
rariable passed by the caller. It will either be equal to 
:eadCacheAccess, or WriteCacheAccess. Then CacheBusy is set for the 
Mime specified by RequestTime.  RequestTime is a local variable. It 
zould equal any of the hit, miss, or access times. Once RequestTime 
las expired then AccessCache will set CacheBusy equal to No, and 
-acheWaiting For egual to Nothing. 





[ 
È 


AccessCache (RequestTime, WaitingForRequest) 





.meType RequestTime; 
init ingForType WaitingForRequest; 


katic TimeType CacheTOA=0; 


i (CacheBusy==Yes && CacheWaitingFor--Nothing ) 

| CacheWaitingFor=CacheWaitingForCPUCacheAccess; 

î (CacheBusy==No EE CacheWaitingFor==CacheWaitingForCPUCacheAccess) 
CacheWaitingFor=Nothing; 


(CacheWaitingFor==Nothing) 

{ 

CacheBusy=Yes; 
CacheWaitingFor-WaitingForRequest; 
CacheTOA=Time+RequestTime; 

) 


b:cordStall(CacheWaitingFor); 


* (CacheTOA«-Time && CacheWaitingFor==WaitingForReauest) 
{ 
CacheBusy=No; 
CacheWaitingFor=Nothing; 
} 
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SelectBlockVictim 
Description: 


SelectBlockVictim chooses the next block tc ^e used, and writes 
the dirty subblocks out to the WriteBuffer. Se =BlockVictim fice 
surveys the cache set that the RequestAddress m<.3 to. The servey 
includes finding the block that was least recently accessed. This 
BlockNumber is stored in LRUBlock. Once the set has been surveyed 
then the ReplacementPolicy dictates how the block is chosen. For the 
LRU policy Request Block Number is set equal to LRUBlock. For the 
FIFO policy CacheNextBlock keeps track of the next victim block for 
each set.  CacheNextBlock is initialized to all zeros during the 
beginning of a run. Therefore it must be checked to see if it Is 
between the first, and last blocks for the set. If it is not then 
CacheNextBlock for SetNumber is reset to FirstBlock. Once 
SelectBlockVictim knows it has a valid Cache Next Block then 
RequestBlock is set equal to it. Then CacheNextBlock for the 
SetNumber is incremented. For RAND policy the block number is chosen 
randomly from all the blocks in the set 


SelectBlockVictim writes all dirty sub blocks to the WriteBuffer 
using WriteDirtySubBlocks. WriteDirtySubBlocks takes care of clearing 
the dirty and valid bits in the block. Once SelectBlockViczim is 
called and it gets to the bottom of the function with Cache..aitingFor 
equal to Nothing then the CacheBlockAddress for the RequestBlockNumber 
is set equal to the block address of RequestAddress. 
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void SelectBlockVictim() 


{ 


SizeType SetNumber 
SizeType FiItSstEloek 
SizeType LastBlock 
SizeType BlockIndex; 
SizeType SubBlockIndex; 


Set (ReguestAddress); 
SetNumber*Associativity; 
FirstBlock+Associa iai 


Il 


TimeType LRUTime 
SizeType LRUBlock; 


Timetl; 
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SelectBlockVictim 
Continued 


* ok 


* ok 


A A 


* * 


A %* 


* %* 


all E E E E EE E kk eee ek A E de dee e e e dede e de e e de ee de e de de de RR / 


2questBlockNumber=FirstBlock; 


or (BlockIndex=FirstBlock; BlockIndex<=LastBlock; BlockIndex++) 
Lal 
if (CacheBlockAddress[BlockIndex]==BlockAddress (RequestAddress)) 
| RequestBlockNumber-BlockIndex; 
| if (LRUTime»LastCacheBlockAccessTime!BlockIndex]) 
{ 
LRUTime=LastCacheBlockAccessTime (BlockIndex); 
| LRUBlock=BlockIndex; 
| ) 
A 
(CacheBlockAddress[RequestBlockNumber]!-BlockAddress (RequestAddress)) 
| 
| switch (BlockReplacementPolicy) 


{ 


gase LRU: 
RequestBlockNumber-LRUBlock; 
LastCacheBlockAccessTime[RequestBlockNumber]-Time; 
break; 


case FIFO: 

if (CacheNextBlock[SetNumber]«FirstBlock || 
CacheNext Block [SetNumber]>LastBlock ) 
CacheNext Block [SetNumber)]=FirstBlock; 

RequestBlockNumber=CacheNext Block [SetNumber] ; 

if (RequestBlockNumber<Last Block) 
CacheNextBlock [SetNumber] ++; 

else 
CacheNextBlock [SetNumber]=FirstBlock; 

break; 


case RAND: 


RequestBlockNumber- (rand()$Associativity)-tFirstBlock; 
break; 


) 
WriteDirtySubBlocks(); 
) 


(CacheWa itingFor==Nothing) 
CacheBlockAddress (ReguestBlockNumber]=BlockAddress (ReguestAddress); 


fede dc 36 d d dc dc s X X X XX X X XX X X + k X X + + k+ k+ + + k+ k k k dk k 
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* * Cache.c 
* * ** 
x+ SetDirtyBits * * 
* * kk 
** Description: "a 
* * ** 
s SetDirtyBits sets the dirty bits for ali sub blocks that contain AM 
** data that was modified by a write request. * * 
* * * % 


de dete de ede dece ke de e dece ke e ehe E e EE e e e AA e e eee DRM 


void SetDirtyBits() 


( 
SizeType SubBlockIndex; 


for (SubBlockIndex-SubBlock (RequestAddress); 
SubBlockIndex«-SubBlock (RequestAddress-*RequestSize-1); 
SubBlockIndex++) 
CacheDirtyBit [RequestBlockNumber] [SubBlockIndex]=Yes; 


Je e ce che ce ce ce cde ode * *x X K X K X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X K X X X X + X X X kK * * *x * * 
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wk 

WriteDirtySubBlocks Xo 

* * 

scription: kk 
* + 

a DirtySubBlocks is called to simulate writing all the dirty I 

ub blocks in RequestBlock. WriteDirtySubBlocks not only clears all WA 
—....its. It also clears all the valid bits. = 


EEE SubBlocks prepares a block to receive new data, and is called ** 
fter a block has been selected as a victim. WriteDirtySubBlocks will  ** 
Nene block for consecutive dirty blocks and splice them together ** 


nto one write request. The write request is then added to the * * 
titeBuffer. All of the sub blocks that make up the request will have ** 
ENNdUBty and valid bits cleared. This process of searching and EE 
Ming ís repeated until all the bits are not dirty. Then all the k * 
alid bits are cleared. * * 


x * 
[3 e de ke de kc de e ke e Ok kk kk ok k k e e Gk e ke e Gk Ok Ok de de He de e He de de K K K d de e ke de K H d K d d de e e / 
| 
WriteDirtySubBlocks () 


zeType Jr 
zeType SubBlockIndex 


0; 


dressType MemoryRequestAddress CacheBlockAddress[RequestBlockNumber]; 
ESType MemoryRequestSize 0; 

iorityType MemoryRequestPriority - WriteDirtyBlockPriority; 

| 


f| eoe e ke cde e de de dede k kk O RR T D 


de de 


de x 


* X 


** 


* k 
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WriteDirtySubBlocks 
continued 


* * 


** 


** 


** 


** 


* * 


d % e he he H d de ee de e O O... 


do 


{ 
MemoryRequestSize=0; 


while ((CacheDirtyBit (ReguestBlockNumber] (SubBlockIndex]==No | | 
CacheValidBit [RequestBlockNumber] [SubBlockIndex]==No) && 
SubBlockIndex«NumberOfSubBlocks) 
SubBlockIndex++; 


MemoryRequestAddress=CacheBlockAddress [Request BlockNumber]) | 
+SubBlock Index*SubBlockSize; 


while (CacheDirtyBit [RequestBlockNumber] [SubBlockIndex]==Yes && 
SubBlockIndex«NumberOfSubBlocks) 
{ 
MemoryRequestSize+=WordSize; 
SubBlockIndex++; 
) 


if (MemoryRequestSize) 

d 

AddToWriteBuffer (MemoryRequestAddress, 
MemoryRequestSize, 
Memory Request ro DIG 

if (CacheWaitingFor==Nothing) 

for (i=0; i<=SubBlockIndex 464 i<NumberOfSubBlocks; i++) 
CacheDirtyBit [RequestBlockNumber]Í[i]-No; 


) 


while (SubBlockIndex«NumberOfSubBlocks && CacheWaitingFor--Nothing); 


if (CacheWaitingFor==Nothing) 


for (i=0; i<NumberOfSubBlocks; i++) 
CacheValidBit [RequestBlockNumber] [i]=No; 


wm. ` Zem ar — 
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AddToReadBuf fer 


Description: 
| AddToReadBuffer takes the elements of a request, and adds the 
request to the ReadBuffer. It will perform all of the searches, and 
meeates necessary to support the appropriate scoreboarding protocals. 

| 

| AddToReadBuffer will begin by searching the cache, and 

MEN Cutter for each byte in the request starting at the beginning of 
the request. Every time a byte is found in one or the other then the 
Address is incremented, while Size and RequiredSize are decremented. 
This simulates removing the available data from the front of the 
request. Then AddToReadBuffer will search the cache, and BlockBuffer 
for the data at the end of the request. Every time a byte is found 
then the Size of the request is decremented by one. If the byte was a 
required byt then the RequiredSize is decremented also. This simulates 
removing any data available from the end of the request. 

Meier GdBurfer is either left with a request that has a Size equal to 
‘zero or the end points are both needed from memory. If the RequiredSize 
lis zero then the request is a buffer hit, otherwize the request is a 
buffer miss. lf the request is already a cache hit then the buffer 
hit is for some block management request. These kinds of buffer hits 
lare not recorded because it would confuse the ResultsDisplay, by making 
tit possible to get a hit rate greater tha 100%. If the Size is not 
‘zero and Remove ReadDuplicates is eaual to No then the request is 

added to the end of the ReadBuffer using Append. Append is a buffer 
EN Ehat adds the request to the end of the buffer. The request 
must be added to the end of the buffer in ouder not to interfere with 
MemoryModel which maybe in the middle of a memory read. If 
RemoveReadDuplicates is equal to Yes then the first byte in the request 
will be spliced into the Read Buffer. 


Splice is another buffer utility. Splice will first search the 
ReadBuffer for the byte if it cant't find a request in the buffer that 
contains the byte then it will search for a read request that is 
getting data from the same block. If one is found then the request is 
modified to include the new read byte request. If no suitable request 
can be found then Splice will add a one byt request to the Read BUffer. 
The Address is then incremented while the Size, and Required Size are 
decremented. Then the cache, and BlockBuffer are searched for the next 
Myce. If it is not found then the next byte is spliced into the 
ReadBuffer. This process is repeated until all of the bytes of the 
request have either been spliced into the ReadBuffer or found. 


The BufferHit is normally defined as when the data is available 
but in the cache. However in order to support the testing of SACS, 
the definition of a buffer hit is redefined to mean that a reguest was 
found to have accrued recently, and that given time to complete all 
Dlock management the requested data would have been in the cache. 

This allows TestSACS to predict the hits of a test run without taking 
into account the time in takes to preform the block management. 


Every time a request is spliced into the read or write buffers 
then the TimeToExecute, and CompletionTimeExtamate must be 
Seeeaiculated. The new time estimates are performed by 
CalculateTimeEstimates. 
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AddToReadBuffer * + 


continued 


Xx 


+ + 
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void AddToReadBuffer (Address, Size, RequiredSize, Block, Priority) 


AddressType Address; 


SizeType Sizes 
SizeType ReguiredSize; 
SizeType Block 


Prioritylype Priority, 


{ 


MemoryRequestType 
YesNotypé 
AddressType 
AddressType 
BufferSizeType 


ReadMemoryRequest. 
ReadMemoryRequest. 
ReadMemoryReguest. 
ReadMemoryReguest. 
ReadMemoryReguest. 
ReadMemoryRequest. 
ReadMemoryRequest. 
ReadMemoryRequest. 


ReadMemoryRequest; 
FoundByte; 
ByteAddress; 
CurrentBlockAddress 
OldReadBufferNext 


Address 

Size 

RequiredSize 

Block 

Priority 
AccessInProgress 
TimeToExecute 
CompletionTimeEstimate 


BlockAddress (Address); 
ReadBuffer.Next; 


Address; 
Size; 
RequiredSize; 
Bleck; 
Priority; 

No; 

0; 

0; 


Ah A dk kk k kk k kk X K KX X X X X X X X X X X X X X X X X de oe oe ode ode de ode e oe oe ode oe oe de de oie oe oe ode oe oe fe oe oe de oe e oe oe oe oe oe oie oe oe ode oe A + 
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* * 

AddToReadBuf fer * * 
continued * * 


* * 


Jk Sk kk de de H H d H He de ke de dh e e e A e e kk e e e e e e ke ke ke e / 


(CacheWaitingFor--CacheWaitingForFullReadBuffer) CacheWaitingFor-Nothing; 


au 
A (FoundByte==Yes && Size>0) 
mi 
FoundByte=No; 
| if (SearchCache (Address)--Yes) 
FoundByte-Yes; 
| else if (SearchBlockBuffer--Yes && Search(&BlockBuffer, Address)) 
FoundByte=Yes; 
if (FoundByte--Yes) 
( 


Addresstt; 
| if (BlockAddress(Address)!-CurrentBlockAddress) Address--BlockSize; 
| if (Size>0) Size--; 


MN RequiredSize>0) RequiredSize--; 
) 
Tt 


iteAddress=Address+Size-1; 
I (BlockAddress (ByteAddress) !=CurrentBlockAddress) ByteAddress-=BlockSize; 
'undByte=Yes; 
Me (FoundByte==Yes 64 Size>0) 
( 
| FoundByte=No; 
if (SearchCache (ByteAddress) ==Yes) 
| FoundByte=Yes; 
else if (SearchBlockBuffer--Yes && Search(&BlockBuffer, ByteAddress)) 
| FoundByte-Yes; 
if (FoundByte--Yes) 
{ 
ByteAddress--; 
if (BlockAddress (ByteAddress) !=CurrentBlockAddress) 
ByteAddress+=BlockSize; 
if (Size>0) size- 
if (RequiredSize»Size) RequiredSize-Size; 
) 
) 


| (Request--Read && Test--No) 
{ 
if (ReguiredSize==0 && CacheHit--No) 
BufferHit=Yes; 
else 
BufferHit=No; 
} 


(RequiredSize==0 && Request--Read) CacheWaitingFor-Nothing; 


adMemoryRequest.Address = Address; 
adMemoryRequest .Size = Size; 
adMemoryRequest .RequiredSize = RequiredSize; 


| (RemoveReadDuplicates==No 46 Size>0) 
Append (&ReadBuffer,&ReadMemoryRequest); 
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AddToReadBuffer 
continued 


ile (Size>0 && RemoveReadDuplicates==Yes) 


{ 


FoundByte=No; 


if (SearchCache (Address)==Yes) 
FoundByte=Yes; 

else if (SearchBlockBuffer==Yes && Search(&BlockBuffer, Address) ) 
PouncdByte=Yes; 


if (FoundByte==No) 
Meee (SReadbuf fer, Address, RequiredSize, Block, Priority) ; 


Addresstt; 

if (BlockAddress (Address) !=CurrentBlockAddress) Address-=BlockSize; 
if (Size>0) Size--; 

RE (RequiredSize>0) RequiredSize--, 


) 


(Reguest==Read 44 Test==Yes) 

{ 

if (ReadBuffer.Next--OldReadBufferNext 66 CacheHit==No) 
BufferHit=Yes; 


else 


BufferHit=No; 
) 


ElculateTimeEstimates (); 


; 
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SS Cdege c x" 
+ + * * 
z SearchCache k 
* ck * te 
** Descrip. a 
x* * * 
`x SearchCache is called by AddToReadBuffer to find any parts of m 
** the request that may be already located in the cache. This must be > 
** done because if a read reguest follows a write reguest using a write Së 
** allocate policy then part of the read may be in the cache while the cii 
** rest may still need to be read from memory. Search Cache checks all = 
**  CacheBlockAddresses in the cache set. If any of the cache block dat 
** addresses equals the block address of the byte, then Search Cache kk 
** checks the CacheValidBit for the sub block that the byte is located in. ** 
** If the sub block is valid then SearchCache returns Yes. SS 
* * * * 


H H de Ye k EET 
YesNoType SearchCache (Address) 
AddressType Address; 


d 


SizeType FirstBlock 
SizeType  LastBlock 

SizeType BlockIndex; 
YesNoType FoundByte; 


Set (Address)*Associativity; 
FirstBlock+tAssociativity l; 


for (BlockIndex=FirstBlock; BlockIndex<=LastBlock; BlockIndex++) 
if (CacheBlockAddress [BlockIndex]==BlockAddress (Address)) 
if (CacheValidBit [BlockIndex] [SubBlock (Address) ]) FoundByte=Yes; 
return (FoundByte) ; 


) 


ée ée x x x x x Xx x x x Xx Xx x x Xx X X X X X X X Xx Xx X X X X X X X X X X X X X X X X X X X X X X X X X X X X kk kk kk kk kk kk kk + X + + + 
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Cache.c * * 

*o* 

AddToWriteBuffer ** 

* x 

lescription: kx 


** 


AddToWriteBuffer adds one record to write buffer. It also updates ** 


he ReadBuffer it the UpdateReadBuffer arguments is asserted. The Kx 
irocess of updating the ReadBuffer is simply changein the requests so => 
hat data make available by the write request is not requested form x 
iemory. UpdateReadBuffer should not be used unless the word and sub TS 
Mock sizes are equal. This is because a write request may reduce a * * 
'ead request to where the read request will not be large enough to SC 
date a sub block. The write request may alsobe unable to set any xx 
alid bits because of sub block alignment. The result is that a sub E 
mock Was supposed to be read in is not. * + 


| * *Y 
ee KX KKK eek eK e kde e e de de de de e e ee eoe de eode ende dece e dede oe de ood eoe dee dede à e x kx * e x n / 


AddToWriteBuffer (Address, Size, Priority) 


idressType Address; 
zeType Size; 
mm... .vivpdpe Priority; 





| 
| 


| 


'moryRequest Type WriteMemoryRequest; 


| sNoType FoundByte; 

dressType ByteAddress; 

'dressType CurrentBlockAddress = BlockAddress (Address); 
| ZeType lio Bytes; 

| fferSizeType OldWriteBufferNext = WriteBuffer.Next; 
 iteMemoryRequest „Address = Address; 
LiteMemoryRequest.Size - Size; 
'iteMemoryRequest.RequiredSize = 0; 
FiteMemoryRequest .Block = 0; 

| iteMemoryRequest .Priority SE 

RN eMemoryRequest .AccessinProgress = No; 
!iteMemoryRequest.TimeToExecute = 0; 


| iteMemoryRequest .CompletionTimeEstimate = 0; 
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de dk 

AddToWriteBuffer * X 
cont inued SE 


** 


ek fe d de d eoe e ede l e e de S 


if (CacheWaitingFor--CacheWaitingForFullWriteBuffer) 
CacheWaitingFor=Nothing; 


FoundByte=Yes; 
while(FoundByte--Yes && UpdateReadBuffer--Yes) 
{ 
FoundByte=No; 
ByteAddress=Address; 
for (NoBytes=0; NoBytes<Size; NoBytes++) 
( 
if (UpdatingReadBuffer (ByteAddress)==Yes) FoundByte=Yes; 
ByteAddress++; 
if (BlockAddress (ByteAddress) !=CurrentBlockAddress) 
ByteAddress-=BlockSize; 
) 
) 


if (RemoveWriteDuplicates--No && Size»0) 
Append(&WriteBuffer, &WriteMemoryRequest); 


while (RemoveWriteDuplicates==Yes 44 Size>0) 
{ 
Splice (éWriteBuffer, Address, 0, 0,Priority); 
Address++; 
if (BlockAddress (Address) !=CurrentBlockAddress) Address-=BlockSize; 
1£ (S1ize>20) Size- 


) 


if (Request--Write) 

{ 

BufferHit=No; 

if (WriteBuffer.Next--OldWriteBufferNext && CacheHit==No) BufferHit=Yes; 

if (WriteBuffer.Next--OldWriteBufferNext && 
CacheWaitingFor !-CacheWaitingForFullWriteBuffer) 
CacheWaitingFor=Nothing; 

) 


CalculateTimeEstimates(); 


) 
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MEMO EYE 


Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 317794 


Mather: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
BEN idea that the above copyright notice appears in all copies. 
modified version of this program should be redistributed without the 
BUEhors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
EEN respect to this software’s ability to produce valid results. 
This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
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Memory.c 


Description: 


Memory.c contains all functions that relate to the simulation of 
main memory. Memory Model makes all the necessary calls to simulate 
main memory. MemoryModel decides which calls to make, based on 
MemoryWaitingFor. This function is called every time Time is 
incremented. If there are no read or write requests waiting to be 
completed, the function does nothing. Memory Model contains a loop 
that forces the procedure to continue modeling until TOA and TOD are 
not equal to Time. This insures that if there are any events that 
occur in zero clock cycles then the next event is allowed to start. 


Memory Model calls SelectMemoryRequest to choose a request from 
either the read or the write buffers. Memory Model calls Start Reads, 
and Start Writes, to simulate accessing memory and receiving the first 
word of a memory request.  ContinueMemoryReads, and 
ContinueMemoryWrites are then called to simulate the memory transfer 
of the following words of data. 


The simulation of main memory includes: 
Choosing memory request from read, write buffers. 
Simulated memory access times. 
Simulated memory transfer times. 


Cache Update after memory read. 
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+include "Global.nh" 
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Memory .C * * 

*o* 

List of Memory.c Function Declarations * * 

x* 

Description: * * 
* ok 

Maas is a list of function declarations within the file scope E 

of Memory.c m 


A TX 
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| MemoryModel (); /* Page 5- 3 */ 
| SelectMemoryRequest (); /* Page 5- 4 */ 
| StartMemoryReads (); / * Page 5- 5 */ 
Cont inueMemoryReads () ; /* Page 5- 6 */ 
| StartMemoryWrites(); /* Page 5- 8 */ 
| ContinueMemoryWrites(); /* Page 5- 9 */ 
| UpdateCache (); E 

AddAWordToMemoryRequest (); Ar Paue M LD9 


| RemoveAWordFromMemoryRequest (); fag da 
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MemoryModel 
Description: 


Memory.c contains all functions that relate to the simulation of 
main memory. Memory Model makes all the necessary calls to simulate 
main memory.  MemoryModel decides which calls to make, based on 
MemoryWaitingFor. This function is called every time Time is 
incremented. If there are no read or write requests waiting to be 
completed, the function does nothing. Memory Model contains a loop 
that forces the procedure to continue modeling until TOA and TOD are 
not equal to Time. This insures that if there are any events that 
Occur in zero clock cycles then the next event is allowed to start. 


Memory Model calls SelectMemoryRequest to choose a request from 
either the read or the write buffers. Memory Model calls Start Reads, 
and Start Writes, to simulate accessing memory and receiving the first 
word of a memory request. ContinueMemoryReads, and 
ContinueMemoryWrites are then called to simulate the memory transfer 
of the following words of data. 


The simulation of main memory includes: 


Choosing memory request from read, write buffers. 
Simulated memory access times. 

Simulated memory transfer times. 

Cache Update after memory read. 
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void MemoryModel () 


while 


MemoryWaitingForType LastMemoryWaitingFor; 


do 


{ 
LastMemoryWaitingFor=MemoryWaitingFor; 


if (MemoryWaitingFor--Nothing) SelectMemoryRequest (&MemoryWaitingFor); 


else if (MemoryWaitingFor--MemoryWaitingForMemoryReadRequest || 
MemoryWaitingFor--MemoryWaitingForCacheUpdate) 
StartMemoryReads () ; 


else if (MemoryWaitingFor--MemoryWaitingForMemoryReadAccess | | 
MemoryWaitingFor--MemoryWaitingForMemoryReadTransfer) 
Cont inueMemoryReads (); 


else if (MemoryWaitingFor--MemoryWaitingForMemoryWriteRequest) 
StartMemoryWrites(); 


else if (MemoryWaitingFor--MemoryWaitingForMemoryWriteAccess | | 
MemoryWaitingFor--MemoryWaitingForMemoryWriteTransfer) 
ContinueMemoryWrites(); 


} 


(MemoryWaitingFor!-LastMemoryWaitingFor || TOA--Time || TOD==Time); 
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* * 

SelectMemoryRequest t 

* + 

Description: * * 


* * 


SelectMemoryRequest is called when memory is waiting for nothing.  ** 





SelectMemoryRequest chooses a request from either the read or write xx 
buffers, based on priority. The request is not returned however, the << 
Suen is left at the top of the buffer with its Priority and Sé 
AccessInprogress set equal to Yes. If a request is found then X X 
MemoryWaitingFor is set to MemoryReadRequest, or MemoryWriteRequest XIX 
depending on whether the request was found in the read or write Ka 
buffers. * * 


* * 
ll... K de Ke K d H d K K H H H K H d D K d d H H de d d e e de De e d K e e de e / 


| SelectMemoryRequest (MemoryWaitingFor) 
| 
lemoryWaitingForType *MemoryWaitingFor; 
| 


emoryRequestType ReadMemoryRequest; 
emoryRequestType WriteMemoryRequest; 


£ (! (ReadBuffer.Empty)) 
ReadMemoryRequest=View (&ReadBuffer) ; 
ise 
ReadMemoryRequest .Priority=NoPriority; 


EU (WriteBuffer.Empty)) 
WriteMemoryRequest=View (&WriteBuffer) ; 
lse 
WriteMemoryRequest .Priority=NoPriority; 


f (ReadMemoryRequest.Priority«-WriteMemoryRequest.Priority && 
ReadMemoryRequest .Priority!=NoPriority) 

{ 
*MemoryWaitingFor-MemoryWaitingForMemoryReadRequest; 
ReadMemoryRequest.AccessInProgress-Yes; 
ReadMemoryRequest .Priority=0; 
ChangeTopMemoryRequest (&ReadBuffer, &ReadMemoryRequest); 
) 

lse if (WriteMemoryRequest.Priority!-NoPriority) 
d 
*MemoryWaitingFor=MemoryWaitingForMemoryWriteReguest; 
WriteMemoryRequest.AccessInProgress-Yes; 
WriteMemoryRequest .Priority=0; 
ChangeTopMemoryRequest (&WriteBuffer,&WriteMemoryRequest); 
) 


[Red kok k dede ede hehe E e e ee ERO AA eee 
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++ 


XX Memory.c ** 
* * * * 
s StartMemoryReads ** 
++ * de 
** Description: ZS 
* + * + 
Ce StartMemoryReads begins a read request, simulating the first word  ** 
** read from memory. The time to complete this read is called D 
** MemoryAccessTime. The BlockBuffer is initialized in preparation to “ 
** receive the new data words. If BlockWaitingFor is not equal to é 
** Nothing the StartMemoryReads will have to wait until it is before WAR 
** allowing the new memory read request to start. If StartMemoryReads "E 
** does have to wait for the cache then MemoryWaitingFor it set equal to WA 
** CacheUpdate, otherwise MemoryWaitingFor is set to MemoryReadAccess. Wk 
** The new block record is equal to the ReadBuffer with its sizes set to kc 
** zero. This gives the Block Memory Request the same block number and Së 
** the ReadMemoryRequest. The Address is aligned to WordSize. The NA 
** Address must be aligned because the words read in will be aligned AE 
** to WordSize. The new BlockMemoryRequest is simply pushed onto the "m 
** Block Buffer. The BlockWaitingFor is set equal to MemoryBlockTransfer.  ** 
** To indicate that data is being transferred from memory to the SE 
** BlockBuffer. SC 
* + + + 


e fe ede EI WA ADORAR SR RO O O A S 


void StartMemoryReads () 


d 


MemoryReguest Type ReadMemoryReguest; 
MemoryRequestType BlockMemoryRequest; 


if (BlockWaitingFor--Nothing) 
{ 


ReadMemoryRequest=View (&ReadBuffer); 


TOA=Time+MemoryAccessTime; 
MemoryWaitingFor=MemoryWaitingForMemoryReadAccess; 


BlockMemoryRequest-ReadMemoryRequest; 

BlockMemoryRequest .Address=WordAddress (ReadMemoryRequest .Address); 
BlockMemoryRequest.Size-0; 

BlockMemoryRequest.RequiredSize-0; 

BlockMemoryRequest.Priority-0; 

BlockMemoryRequest .AccessInProgress=NO; 
Push(&BlockBuffer,&BlockMemoryRequest); 


BlockWaitingFor-MemoryBlockTransfer; 


) 


else 
{ 


MemoryWaitingFor=MemoryWaitingForCacheUpdate; 


) 
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ContinueMemoryReads 






Description: 


ContinueMemoryReads continues the memory read reguest started by 
StartMemoryReads. It simulates every read from memory other than the 
first word which was simulated by StartMemoryReads. The time to 


complete each word transfer is equal to MemroyTransferTime. The block, 


and read buffers are altered every time a word is read from memory. 
Once a request is complete, it is removed from the Read Buffer, and 
Memory WaitingFor is reset to Nothing. Block Waiting For is set to 
BlockCacheAccess in preparation to transfer the new data to the cache. 
If the CompletionTimeEstimate for the memory read request is not equal 
to Time then a time predition error is rased. 


ContinueMemoryReads () 


| 
emoryRequestType BlockMemoryRequest; 


'emoryRequestType ReadMemoryRequest; 
f (TOA<=Time) 
{ 


BlockMemoryRequest=View (&BlockBuffer) ; 
AddAWordToMemoryRequest (&BlockMemoryRequest) ; 
ChangeTopMemoryRequest (&BlockBuffer, &BlockMemoryRequest) ; 


ReadMemoryRequest=View (&ReadBuffer) ; 
RemoveAWordFromMemoryRequest (&ReadMemoryRequest) ; 


if (ReadMemoryRequest.Size»0) 
{ 
ChangeTopMemoryRequest (&ReadBuffer, &ReadMemoryRequest) ; 
TOA=Time+MemoryTransferTime; 
MemoryWaitingFor=MemoryWaitingForMemoryReadTransfer; 
) 

else 
{ 
Pop (&ReadBuffer) ; 
TOA=0; 
if (Time!-ReadMemoryRequest.CompletionTimeEstimate) 


s se se k k k kx k * k k x k e ce ee kx e ce e * k k k k * k kx de dee ce A 


** 


* % 


kk 


kk 


** 


* *x 


* * 


* * 


kk 


** 


*o* 


* * 


* + 


* ok 


* * 


* * 


kk 


NEE E oko oko ok Rok ke Rok ok de de e Ro RARA e e ke e e ke e Y 


PrintTimePredictionError (ReadMemoryRequest.CompletionTimeEstimate, 


Time, 

"Read" : 

"ContinueMemoryReads"); 
MemoryWaitingFor=Nothing; 
BlockWaitingFor=BlockCacheAccess; 
BlockTOA=Time+BufferCacheAccessTime; 
a 

TotalNumberOfWordsReadFromMemorytt; 


} 


** 


f ee ee dece de de de de de e e e e de ee ehe e she e e c e eC ICE TORE E MD CODEC 


* x 


* kr 


** 


** 


X 


de de 


Memory .c 


Cont inueMemoryReads 
continued 


Page 


gan 


* * 


* * 


** 


* * 


* * 


WA 


e e e fe e k k kk ek k de ee te ke te he he te ke he he e e he ee eK KE XA Sa Ya aa Yea ja WA EA AAA R 


else 


{ 


ReadMemoryRequest=View (&ReadBuffer); 


LE 


(ReadMemoryRequest.Size==0) 


" 

Pop (&ReadBuf fer); 

TOA=0; 

if (Time!-ReadMemoryRequest.CompletionTimeEstimate) 


PrintTimePredictionError (ReadMemoryRequest.CompletionTimeEstimate, 


Time, 

"Read" S 

"ContinueMemoryReads"); 
MemoryWaitingFor=Nothing; 
BlockWaitingFor=BlockCacheAccess; 
BlockTOA=Time+BufferCacheAccessTime; 
) 


HR RRA AAA AA A AA A AA AA AA A AA AAA X X X X X X X X X X X X X X X X X X X X K K NX X X + + + + + NX + K + K + + + kk + N + + + + 
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** 

StartMemoryWrites SEL 

* * 

Description: * * 
* * 

StartMemoryWrites begins a memory write reguest, simulating the di 
first word written to memory. The time to complete this one word write ** 
iis called MemoryAccessTime.  MemoryWaitingFor is set to x 
MemoryWriteAccess. * * 


* * 


[t ie sk de de de e e e ko de de de de de de kok e e de c c e He de de e d ke ie e de He de de Àe d de de de e e de He d de À e e e À H K e e H K $ $ H e e $ $ $ ke e e / 
J 


| StartMemoryWrites() 


f (MemoryWaitingFor--MemoryWaitingForMemoryWriteRequest) 
1 
TOD=Time+MemoryAccessTime; 
MemoryWaitingFor=MemoryWaitingForMemoryWriteAccess; 


ID! 


í. = 


fede kok k kk dc de k k o de ec e ee Se TTT 


SS Rage 5- 9m 
SCH Memory. ibe 
+ + * * 
te ContinueMemoryWrltes KS 
* t ** 
EE wi 
* + * + 
ER ContinueMemoryWrites continues the memory write request started Kë 
** by StartMemoryWrites. Like ContinueMemoryReads, it simulates every KK: 
** write to mwmory Other than the first word which was simulated by iii 
**  StartMemroyWrites. The time to complete each word transfer is equal "m 
** to MemoryTransferTime. The Write Buffer is altered every time a word "ah 
** is written to memory. Once the memory write request is complete, it > 
** is removed form the WriteBuffer, and MemoryWaitingFor is reset to "a 


** Nothing. If the CompletionTimeEstimate for the memory read request is  ** 
** not equal to Time when the request is completed then a time predition SS 


** error is rased. * * 
* + x 


d H H H eode dee dece de dece de hehe e ek d A A i 


void ContinueMemoryWrites () 


{ 
MemoryRequestType WriteMemoryRequest; 


if (TOD«-Time) 
( 
WriteMemoryRequest=View (&WriteBuffer) ; 
RemoveAWordFromMemoryRequest (&WriteMemoryRequest); 
if (WriteMemoryRequest .Size>0) 
{ 
ChangeTopMemoryRequest (&WriteBuffer,&WriteMemoryRequest); 
TOD=Time+MemoryTransferTime; 
MemoryWaitingFor=MemoryWaitingForMemoryWriteTransfer; 
} 
else 
{ 
Pop (&WriteBuffer) ; 
TOD=0; 
if (Time!-WriteMemoryRequest.CompletionTimeEstimate) 
PrintTimePredictionError (WriteMemoryRequest.CompletionTimeEstimate, 
Time, 
"Write", 
"ContinueMemoryWrites"); 
MemoryWaitingFor=Nothing; 
} 
TotalNumberO0fWordsWrittenToMemory++; 
) 
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** 

ContinueMemoryWrites xx 
continued E 


** 


l ek ke e ee e ee de eoe oe See e e ede e e AAA / 


lse 
{ 
WriteMemoryRequest=View (&WriteBuffer) ; 
if (WriteMemoryRequest .Size==0) 
{ 
Pop (&éWriteBuffer) ; 
TOD=0; 
if (Time!=WriteMemoryRequest .CompletionTimeEstimate) 
PrintTimePredictionError (WriteMemoryRequest.CompletionTimeEstimate, 
Time, 
"Write", 
"ContinueMemoryWrites"); 
MemoryWaitingFor-Nothing; 
) 


f ERE de S ECG 


*o* 


*o* 


* * 


*o* 


* * 


*o* 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


* * 


*o* 


* * 


* + 


* + 


* * 


* de 


* * 


** 


* * 


Description: 
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UpdateCache 


UpdateCache simulates entering data from the BlockBuffer into the 
cache. UpdateCache first checks wheter of not the cache is busy. If 
it is not then CacheBusy is asserted, and BlockWaitingFor is set equal 


to BlockCacheTransfer. 


The BlockTOA is calculated, to enable 


CalculateTimeEStimates to predict the completion times for additional 
memory read request in the buffer. If the cache is busy then the 
previous memory request time completions may be wrong. That is because 
the last estimates conunted on the old BlockTOA. This means that all 
the time estimates must be recalculated. 


Once the BufferCacheAccessTime has expired then BlockWaitingFor 


is set egual to Nothing, 


and the CacheBusy is deserted. The read data 


must then be removed from the BlockBuffer. The appropriate sub blocks 
in the cache will then have there dirty bits cleared, and valid bits 


sets 


* + 


* + 


* * 


* + 


* * 


* * 


* * 


* * 


* X 


* * 


* * 


* + 


* * 


* * 


* + 


* + 


*o* 


* * 


* * 


** 


* % 


* * 


* + 
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void UpdateCache() 


{ 


MemoryRequestType BlockMemoryRequest; 


AddressType 


TempAddress; 


xk *x x e oe oe oe oe e ï e e ee X X X H H KKK KKK KKK KKK KKK KKK KKK 


Dump IS 


Memory.c * * 

* Y 

UpdateCache AUS 
continued ** 


x* 


7 on mor o eo desde deck e ee ede ke e de e de e de de e e de e de e de eee e e de e e e de d e / 
h 
| 


if (BlockWaitingFor==BlockCacheAccess && CacheBusy==Yes) 
t f 
BlockTOA=Time+BufferCacheAccessTime+l; 
CalculateTimeEstimates(); 


) 


f (BlockWaitingFor--BlockCacheAccess && CacheBusy==No) 
{ 

CacheBusy=Yes; 

BlockTOA=Time+BufferCacheAccessTime; 
BlockWaitingFor=BlockCacheTransfer; 


m 


f (BlockWaitingFor--BlockCacheTransfer && BlockTOA<=Time) 
kA 
CacheBusy=No; 
BlockWaitingFor=Nothing; 
BlockTOA=0; 
BlockMemoryRequest=Pop (&BlockBuffer) ; 
if (CacheBlockAddress [BlockMemoryRequest .Block] == 
BlockAddress (BlockMemoryRequest .Address)) 
{ 
for (TempAddress-BlockMemoryRequest.Address; 
TempAddress<=BlockMemoryRequest .Address 
+BlockMemoryRequest .Size-1; 
TempAddress+=SubBlockSize) 
{ 
CacheDirtyBit [BlockMemoryRequest.Block] [SubBlock (TempAddress) ] No; 
CacheValidBit [BlockMemoryRequest .Block] [SubBlock (TempAddress) ]=Yes; 
) 


) 

lse 
{ 
BlockMemoryRequest=View (&BlockBuffer) ; 
BlockMemoryRequest .TimeToExecute=BufferCacheAccessTime; 
BlockMemoryRequest.CompletionTimeEstimate-BlockTOA; 
ChangeTopMemoryRequest (&BlockBuffer, &BlockMemoryRequest) ; 


f K K * H H TE de de H He de de de He H d REC ATE He H He RAEE E Ne de de He de AI E E AE E ATA RAT OA E AE RA AE a e 


** 


** 


** 


** 


de de 


** 


*% 


de de 


* o + 


de de 


** 


Page 5-13 
Memory.c 


AddAWordToMemoryRequest 
Description: 
AddAWordToMemoryRequest adds a word to a MemoryRequest as if it 


had been read in from memory. The address is first aligned to 
WordSize. This simulates the data being added to the request. 


** 


** 


A de 


de + 


A de 


xk 


I % * *% de de IIIA T T 


void AddAWordToMemoryRequest (MemoryRequest) 


MemoryRequestType *MemoryRequest; 

{ 

MemoryReguest->Address=WordAddress (MemoryReguest->Address); 
MemoryRequest->Size+=WordSize; 


) 


de e e ce cc de de de de de de de de de de de de de de de de e de X e oe de de de de de de de de de de de de de de de de e e e A DT kk 
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RemoveAWordFromMemoryRequest 


Description: 


RemoveAWordFromMemoryRequest removes a word from a Memory Request, 


^as if it had been written to memory. A copy of the Address is first 


stored in OldAddress. Then the Address is word aligned and incremented 


—...e. The Required Size, and Size are then decremented by the 
difference of the new Address, and the OldAddress. Finally if the 
Address is outside the range of the original block then the Address is 
decremented by BlockSize to simulate modulo addition. This simulates 
removing a word from the memory request taking into account word and 
block alignment constraints. 


* de 


* h 


* * 


* * 


Ao 


* * 


* * 


+ + 


* * 


* * 


* * 


* * 


** 


dd 


* * 


** 


* * 


Be e e ce de de de d de de de e e de e He de de d de e de de e e e He de de RAR e de e kc e de de de d d He d de de de de de He de e c de de d d d d e tee tee te tee tee te / 


i RemoveAWordFromMemoryRequest (MemoryRequest) 


4emoryRequestType *MemoryRequest; 


| 
| 


{ 
AddressType OldAddress=MemoryReguest->Address; 
MemoryRequest->Address=WordAddress (MemoryRequest->Address)+WordSize; 


if (MemoryRequest->Size>BlockSize-WordSize) 
MemoryRequest->Size=BlockSize-WordSize; 

alse if (MemoryRequest->Size>MemoryRequest->Address-OldAddress) 
MemoryRequest->Size-=MemoryRequest->Address-OldAddress; 

alse 
MemoryRequest->Size=0; 


if (MemoryReguest->ReguiredSize>BlockSize-WordSize) 
MemoryRequest-»RequiredSize-BlockSize-WordSize; 

2lse if (MemoryRequest->RequiredSize>MemoryRequest->Address-0ldAddress) 
MemoryRequest->RequiredSize-=MemoryRequest->Address-OldAddress; 

ES e 
MemoryRequest->RequiredSize=0; 


if (BlockAddress (0ldAddress)<BlockAddress (MemoryRequest->Address) ) 
MemoryRequest->Address-=BlockSize; 


f KK kk kk ke ke de c kk Ok Ok kc Ok Ok X XX X X XX X XX X X XXX XNXX XXX NX de e e de K H K d K H de d d Ok kc Ok Ok OK X XX XX X X XX XX X XX XX X 


* ck 
* ok 
dk 
* * 
* * 
* * 
** 
** 
** 
* * 
* * 
* À 
* * 
* * 
A ve 
* * 
* ok 
* ok 
* ok 
* * 
* * 
* * 
* + 
** 
** 
** 


** 


Page 6- 0 
TimeEst.c 


Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies a 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 
This program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
user. 


* ck 
* * 
* * 
* * 
* * 
** 
* * 
* * 
* ok 
* * 
* * 
* * 
** 
** 
** 
* H 
*x $X 
** 
* * 
** 
** 
* * 
** 
* o 
* % 
** 


** 
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TimeEst.c 


escription: 


xecution, and completion times of memory reguests. 


| 


i 
| 
| 


Table of Contents 


moner Bage .......... E ee e .. Page 
Ms of BimeEst.c Function Declarations ... Page 
Mt neToExecute() .... ©... ©... e SECH Page 
CalculateTimeEstimates() ......... SE Page 


Page 


TimeEst.c contains ali functions that relate to estimating the 
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kk 
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** 


+ + 


** 


A oe 


** 


* * 


kk 


x* 


** 


* * 


xk 


* + 
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* k 


* ok 


+ * 


de x 


* dr 


* * 


* * 


* ox 


* dr 


* + 


Description: 


This is 
of TimeEst.c 


Page 
TimeEst. c 


List of TimeEst.c Function Declarations 


a list of function declarations within the file scope 


6- 


2 


x 
wk 
A e 
de * 
* * 
* dr 
A Y 
* * 
* * 


** 


dece de hee desee ee O... 


void UpdateTimeToExecute(); /* Page 
void CalculateTimeEstimates(); /* Page 


O 
600 
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UpdateTimeToExecute 
Description: 


UpdateTimeToExecute calculates the time to complete a memory 
transfer given the MemoryRequest. The Memory Request could be a read 
lor write request in a buffer.  UpdateTimeToExecute changes the 
TimeToExecute field to the new value.  TimeToexecute is calculated by 
first finding the number of WordsToBeTransfered. If the MemoryRequest 
En not being accessed then the TimeToExecute is simply the AccessTime 
‘plus the TransferTime times one less then WordsToBeWritten. If the 
¡MemoryRequest is in progress then the new TimeToExecute is dependent 
ton TOA, or TOD of the next word. MemcryWaitingFor dictates whether to 
‘use the TOA, or TOD. If MemoryWaitingFor is equal to CacheUpdate then 
the request has not actually begun transferring data. So the 
TimeToExecute can be calculated as if the read request is not in 
Progress. 


x * 


* * 


+ + 


* * 


* * 


* * 


* * 


** 


** 


** 


** 


* * 


* * 


* * 


** 


* + 


* * 


* + 


** 


* * 


** 


[^ 3e e ECKE e e e e ke e e e e ke / 
1 


1 UpdateTimeToExecute (MemoryRequest) 


lemoryRequestType *MemoryRequest; 


sizeType WordsToBeTransfered; 


.£ (MemoryReguest->Size>0) 
{ 
WordsToBeTransfered=WordAddress (MemoryReguest->Address 
tMemoryRequest->Size-1) 
-WordAddress (MemoryRequest->Address)+WordSize; 
) 
lse 
( 
WordsToBeTransfered=0; 
) 


lordsToBeTransfered/-WordSize; 


.£ (WordsToBeTransfered» (BlockSize/WordSize)) 
WordsToBeTransfered-BlockSize/WordSize; 


f**** k O aaa O... 


k Page 6— 4 Sa 
NX TimeEst.c = 
KA * x 
x UpdateTimeToExecute gt 
xx continued m 
*o* *o* 


Ye fe he eee dee ee eee ee e e ee e e AA E E X c -:--:- : Aa 


if (WordsToBeTransfered>0) 
{ 
if (MemoryReguest->AccessinProgress==No) 
{ 
MemoryReguest->TimeToExecute=MemoryAccessTime 
+MemoryTransferTime* (WordsToBeTransfered-1) ; 
) 
else 
{ 
1f (MemoryWaitingFor==MemoryWaitingForMemoryReadAccess || 
MemoryWaitingFor==MemoryWaitingForMemoryReadTransfer) 
{ 
MemoryRequest->TimeToExecute=TOA-Time+tMemoryTransferTime 
* (WordsToBeTransfered-1); 
) 
else if (MemoryWaitingFor--MemoryWaitingForMemoryWriteAccess || 
MemoryWaitingFor--MemoryWaitingForMemoryWriteTransfer) 
{ 
MemoryRequest->TimeToExecute=TOD-TimetMemoryTransferTime 
* (WordsToBeTransfered-1); 
} 
else if (MemoryWaitingFor==MemoryWaitingForCacheUpdate) 
{ 
MemoryReguest->TimeToExecute=MemoryAccessTime+MemoryTransferTime 
* (WordsToBeTransfered-1); 
) 
else 
{ 
printf ("Error found in [UpdateTimeToExecute] MemoryRequest\n") ; 
printf ("with access in progress while MemoryWaitingFor not\n"); 
printf ("reading or writing."); 
DiscrepancyFound=Yes; 


) 


) 
else 


{ 


MemoryRequest->TimeToExecute=0; 


) 


e, E 
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kk 

CalculateTimeEstimates ** 

* *Y 

Jescription: * * 
* *Y 

! CalculateTimeEstimates updates the CompletionTimeEstimates for iei 
Sach request in both the read and write buffers. This funtion is 26 
called when ever the CacheModel adds to the read or write buffers. ne 
MeliculateTimeEstimates must be called every time new data is entered or 
into the buffers. This is because all previous estimates did not take ** 
into account the new data requested. This is because all previous ** 
sstimates did not take into account the new data requested. >- 
ZalculateTimeEstimates first orders all entries in both the ReadBuffer, ** 
and the WriteBuffer by priority. Then CalculateTimeEstimates steps YA 
MON both buffers simultaneously. Each time picking the request that ** 
lies the highest priority, and adding the time to execute to the i 
TimeEstimate. The TimeEstimate becomes that requests XN 
SempletionTimeEStimate. This process is repeated until all requests È 
nave a new CompletionTimeEstimate.  TimeToExecute for cache request is ** 
Medated before it is used to calculate the TimeEstimate. AN 


* * 
fe t e e e e de de de de d de d eode de de de e e X XX XX XXX X XX XXX XXX X XX XXX X XKX XXX X KNX ale e ede / 


| CalculateTimeEstimates() 


afferSizeType ReadIndex=0; 

ifferSizeType WriteIndex=0; 

imeType TimeEstimate=Time; 

imeType BlockTOAEstimate=BlockTOA; 


cder (&ReadBuffer); 
cder (&WriteBuffer); 


* *Y 


ee ke ec k e ee k o e de S o. a 


A od 


* X 


kk 
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** 


* X 
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* + 

CalculatelameBsteimates TAN 
continued * * 


dd 


o ee O O a MU CC HM WA OO 


while (ReadIndex«ReadBuffer.Next || Writelndex<WriteBuffer.Next) 


{ 
if (ReadIndex«ReadBuffer.Next && Writelndex<WriteBuffer.Next) 


{ 
if (ReadBuffer.MemoryRequest[ ReadIndex ].Priority <= 
WriteBuffer.MemoryRequest[WriteIndex].Priority) 


{ 
UpdateTimeToExecute (6 (ReadBuffer.MemoryReguest [ReadIndex])); 


if (TimeEstimate<BlockTOAEstimate) TimeEstimate=BlockTOAEstimate; 
TimeEstimate+=ReadBuffer .MemoryRequest [ReadIndex] . TimeToExecute; 
ReadBuffer .MemoryRequest [ReadIndex] .CompletionTimeEstimate= 
TimeEstimate; 

BlockTOAEstimate=TimeEstimate+BufferCacheAccessTime; 
ReadIndex++; 
) 

else 


{ 
UpdateTimeToExecute (& (WriteBuffer.MemoryRequest [WriteIndex])); 


TimeEst imate+=WriteBuffer.MemoryRequest [WriteIndex] .TimeToExecute; 
WriteBuffer.MemoryRequest[WriteIndex].CompletionTimeEstimate- 
TimeEstimate; 
Writelndex++; 
) 
) 
else if (ReadIndex<ReadBuffer.Next) 


{ 
UpdateTimeToExecute (4 (ReadBuf fer .MemoryRequest [ReadIndex])); 


if (TimeEstimate<BlockTOAEstimate) TimeEstimate=BlockTOAEstimate; 
TimeEst imate+=ReadBuffer.MemoryRequest [ReadIndex] .TimeToExecute; 
ReadBuffer.MemoryRequest [ReadIndex] .CompletionTimeEst imate= 
TimeEstimate; 

BlockTOAEst imate=TimeEst imate+BufferCacheAccessTime; 
ReadIndex++; 
) 

else if (WriteIndex«WriteBuffer.Next) 


{ 
UpdateTimeToExecute (& (WriteBuffer.MemoryRequest[WriteIndex])); 


TimeEstimate+=WriteBuffer.MemoryRequest [WriteIndex].TimeToExecute; 

WriteBuffer.MemoryRequest[WriteIndex].CompletionTimeEstimate- 
TimeEstimate; 

Writelndex++; 

) 
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Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


menor: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 

Monterey, CA 93940 


Copyright 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 
its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 
program is provided "as is" any financial, personal or property 
damage caused by the use of this program is the responsibility of the 
fuser. 
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Get.c 


Description: 


Get.c contains all functions that relate getting the next CPU 


request. 


file scope. 
an input file. 


r 
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GetNextRequest is the only procedure called outside of this 
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It determines whether to take input from the keyboard or 
It also checks the input data to see if it makes sense. 
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 GetNextRequest () ; /* Page 7- 3 */ 
-© GetNextFileReguest (); /* Page 7- 5 */ 
GetNextKeyBoardRequest (); EE NO 
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GetNextRequest 
Description: 


GetNextRequest gets the next simulated request from the CPU to 
cache (ie a Read or Write request). The request is checked to make 
sure it makes sense. If a request is not block alined, then 
GetNextRequest will split the request up and return portions of the 
request until all portions have been used, as if the user had made 
several different requests. 
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void GetNextRequest () 


( 


static AddressType NextRequestAddress; 
static SizeType NextRequestSize=0; 
static RequestType NextRequest; 
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f (NextRequestSize»0) 


1 
if (NextRequestSize<=BlockSize) 


NextReguestSize=0; 
) 
Else 
{ 
RequestSize=BlockSize; 
NextRequestSize-=BlockSize; 
} 
ge questAddress=BlockAddress (RequestAddress)+BlockSize; 
| Request-NextRequest; 
) 


| 
{ 
Request Size=NextRequestSize; 


lse 


{ 


if (KeyBoardIO) 
1 
PauseForCommand(); 
GetNextKeyBoardRequest (); 
) 
else 
1 
GetNextFileRequest (); 
) 


if (BlockAddress (RequestAddress) != 
BlockAddress (RequestAddress+RequestSize-1)) 
1 
NextkRequestSize=RequestSize; 
ReguestSize= (BlockAddress (ReguestAddress)+BlockSize)-ReguestAddress; 
m eguestSize-=ReguestSize; 
NextReguestAddress=BlockAddress (ReguestAddress)+BlockSize; 
NextReguest=Reguest; 
) 


) 


F (Request !=None) 
{ 
LastReguest=Reguest; 
NumberOfAccesses [Request ] ++; 
} 
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GetNextFileRequest 


Description: 


1225 


GetNextFileRequest reads in one request, without doing any error 
checking. 


** 
* * 
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void GetNextFileRequest () 


{ 


char RequestChar=" ', 


, 


Chr; 


Request=None; 


ae 


(feof (DataFile)) EndOfDataFile=Yes; 


while (RequestChar!-'r' && RequestChar!-'w' && RequestChar!-'E' && 


IE 


LE 


EndOfDataFile==No 464 !feof(DataFile) ) 
fscanf (DataFile, "%c", &RequestChar) ; 


(feof (DataFile) || RequestChar==’E’) EndOfDataFile=Yes; 


(EndOfDataFile==No) 
{ 


fscanf (DataFile,"%lX", &RequestAddress) ; 
fscanf(DataFile, "$u", &RequestSize); 
fscanf(DataFile, "$U", &TimeOfNextRequest); 


if (RequestChar--'r') Request-Read; 
if (RequestChar--'w') Request=Write; 


TimeOfNextRequest+=Time; 
while (RequestChar!=' in” && !feof(DataFile) ) 


fscanf (DataFile, "%c", &RequestChar) ; 
} 


if (feof (DataFile)) EndOfDataFile=Yes; 


) 
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Description: 


checking. 
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GetNextFileRequest reads in one request, without doing any error 
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GetNextKeyBoardRequest () 


r chr; 


rintf ("Please enter request type (r,w). "); 
hile (chr!="r“ && chr!-'w' && chr!-'q') 
It 
Eoanf("$c", &chr); 
I 
£ (chr=="q') exit (0); 
f (chr--'r') Request-Read; else Request=Write; 
rintf ("Please enter Address "); 
canf("%U", &RequestAddress); 
rintf("Please enter size "); 
Emmf('S$u", &RequestSize); 
Sect ("Time until next request. "); 
Sesh (stdin) ; 
canf("£U", &TimeOfNextRequest); 


imeOfNextRequest+=Time; 


f * k dee dede O de H H H K dH H H de de de SA H AA E RR RE 


** 
de * 
* + 
* Y 
kk 
* * 
* X 
** 
** 
** 
A + 
A Y 
de de 
de de 
** 
** 
X + 
* x 
** 
** 
* x 
* * 
** 
* * 
* * 
** 


*% 


Display.c 


Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 
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its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. 
modified version of this program should be redistributed without the 


authors consent. William G. Smith makes no warranty or 


No 


representation, promise of guarantee, either expressed or implied, 


with respect to this software's ability to produce valid results. 


This program is provided "as is" any financial, personal or property 


damage caused by the use of this program is the responsibility of the 


user. 
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EEE Dlay.c contains all display functions used within 
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List of Display.c Function Declarations 


** = Descrip t Ton: 
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This is a list of function declarations within the file scope 


** of "Digplay Ci 
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vola 
void 
void 
void 
void 
void 


vods 
void 


void 


Scoretype 


vola 
void 


void 


void 
void 
void 
void 
void 
void 
void 
void 


void 
void 
void 
void 
vola 
void 
VOX 
void 
void 
void 
void 


void 
void 
void 


DisplayTrace (); 
DisplayCurrentReéequest (); 
DisplayWaitingFors(); 
DisplayBlock(); 
DisplayBuffers(); 

DisplayBuffer(); 


DisplayReguestsBreakDown(); 
DisplayRequestHistogram(); 


DisplayStallHistogram(); 

LastScreenHistogramScore(); 
DisplayCacheArguments (); 
DisplayHelp (0); 


DisplayTestingHeader(); 


PrintYesNo(); 
PrintRequest (); 
PrintReplacementPolicy(); 
PrintWritePolicy(); 
PrintWriteMissPolicy(); 
PrintWaitingFor(); 
PrintMemoryWaitingFor(); 
PrintBlockWaitingFor(); 


PrintTime(); 
PrintTimeCentered(); 
PrintScoreCentered(); 
PrintAddress(); 
PrintCacheSize(); 
PrintSize(); 
PrintSize2(); 
PrintBufferSize(); 
PrintPriori6:0(0- 
PrintAssociativity(); 
PrinctHistogramTIndex() ; 


PrintBit(); 
PrintPercent(); 
PrintAveAccess(); 
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DisplayTrace X X 
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| 
| 
| DisplayTrace () 
|; 


AL Block0=Set (RequestAddress) *Associativity; 
izeType BlockIndex; 
izeType SubBlockIndex; 


ystem(ClearScreen) ; 


isplayCurrentRequest (); 
isplayWaitingFors(); 


Entf ("Nin"); 

—.i.!(" Set Block Address "); 

5r (SubBlockIndex-0; SubBlockIndex«NumberOfSubBlocks; SubBlockIndex--*) 
E ntf(" V/D "); 

meet ("\n"); 


ap (BlockIndex=Block0; BlockIndex<Block0+Associativity; BlockIndex++) 
DisplayBlock (BlockIndex); 


meats ("\n"); 


isplayBuffers(); 


f None ee e dece ede de de Fe K de de de e ee o de d de aaa aa RU RO EE 
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void DisplayCurrentRequest () 


{ 
if (Request !=None) LastRequest-Request; 


if (LastReguest==None) 
{ 
RequestAddress=0; 
ReguestSize=0; 
CacheHit=No; 
) 


if (Request !=None) LastRequest=Request; 
if (CacheWaitingFor!=Nothing) 
{ 


printf("\nCurrent Request: ao 
) 
else 
{ 
printf ("XnLast Request: 1); 


) 


PrintRequest (Las rkecuest); 
Printia Time: WA e 
PrintTime (Time); 


printf("\nAddress: "); 
PrintAddress (RequestAddress) ; 
printed Next. Request lame mee). 


PrintTime (TimeOfNextReauest); 


printf (“n ze: 1); 
PrintSizez2 (Requestsize); 


if (MemoryWaitingFor==MemoryWaitingForMemoryReadAccess | | 
MemoryWaitingFor==MemoryWaitingForMemoryReadTrans fer) 
{ 
| TOA: V 
PrintTime (TOA); 
} 

if (MemoryWaitingFor==MemoryWaitingForMemoryWriteAccess || 
MemoryWaitingFor--MemoryWaitingForMemoryWriteTransfer) 
{ 
Print: TOD: SE 
PrintTime (TOD); 
} 


print E (an, 


) 
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i DisplayWaitingFors() 


»rintf( "Cache Waiting for: ^"); PrintWaitingFor (CacheWaitingFor); 


A Waiting For: "); PrintMemoryWaitingFor (MemoryWaitingFor); 


rintf(" Cache Hit: 1); PrintYesNo (CacheHit); 
M: c("AnBlock Waiting For: "); PrintBlockWaitingFor (BlockWaitingFor) ; 
int f (" Buffer Hit: "); PrintYesNo(BufferHit); 


ENUtf ("Wn"); 
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DisplayBlock 
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void DisplayBlock (BlockIndex) 


SizeType BlockIndex; 


{ 
SizeType SubBlockIndex; 


if (BlockIndex$Associativity--0) 
{ 
PrintSize (BlockIndex/Associativity) ; 
) 

else 


{ 
print É (” yos 


} 
princ) 


PrintSize (BlockIndex); 
printr(o s 
PrintAddress (CacheBlockAddress [BlockIndex} ); 


for (SubBlockIndex=0; SubBlockIndex<NumberOfSubBlocks; 
{ 
peer (ns 
PrintBit (CacheValidBit [BlockIndex] [SubBlockIndex]); 
print E (Ca 
PrintBit (CacheDirtyBit [BlockIndex] [SubBlockIndex]); 
prrutrt( 
} 


Princ EAn 


} 


SubBlockIndex++) 
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| 
| DisplayBuffers () 


»rintf("Read Buffer "); 
jisplayBuffer(sReadBufífer); 


manten"); 
Euntf("Write Buffer "); 
JisplayBuffer(sWriteBuffer); 


EEntf ("Nin"); 
Mt f ("Block Buffer "); 
JisplayBuffer (£BlockBuffer); 


f ok k de d ede ehe ee ehe e ehe de de e de de de de e ee o. 
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* * Dusplay.c lg 
** kk 
* * DisplayBuffer * * 
** ** 
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void DisplayBuffer (PrintBuffer) 
BufferType *PrintBuffer; 


{ 


int R; 
printf ds Address Size Rea Block Priority); 
printf(" Time Reg. Comp. Timein"); 


for (R=0; R<PrintBuffer->Next; R++) 
{ 


Donuts" n 

PrintAddress (PrintBuffer->MemoryRequest [R] .Address); 
printer "); 

PrintSize2 (PrintBuffer-»MemoryRequest [R] .Size); 

Prom "di 
PrintSize2(PrintBuffer->MemoryRequest [R] .RequiredSize); 
PINE cs 7957 
PrintSize(PrintBuffer-»MemoryRequest [R].Block); 
PENET" FE 

PrintPriority (Print Butfer—>MemoryRequestiRi Priority), 
Deine is 
PrintTimeCentered(PrintBuffer-»MemoryRequest[R].TimeToExecute); 
prometo JO 


PrintTimeCentered(PrintBuffer->MemoryReguest [R] .CompletionTimeEstimate); 
printf (Nm): 
) 
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1 DisplayRequestsBreakDown() 


| 


IgoreType 


TotalNumberOfAccesses =NumberOfAccesses [Read] +NumberOfAccesses [Write], 
TotalNumberOfCacheHits=NumberOfCacheHits [Read] +NumberOfCacheHits [Write], 
TotalNumberOfBufferHits=NumberOfBufferHits [Read] +NumberOfBufferHits [Write] ; 


Wwéetem(ClearScreen); 


gnt CZ ("\n Requests Break Down\n"); 
int £ ("An "); 

ëffent f(" Number Number Number 

bruintf ("Mn E) 

REC É ("Request Of of Of Es 
Entf ("Mn ys 

)rintf(" Types Requests Cache Hits Buffer Hits Rates 
nf ("On"); 

int f£ ("An Read "yc 

rintScoreCentered (NumberOfAccesses[Read]); 

ntf (" E; 

rintScoreCentered (NumberOfCacheHits[Read]); 

ent T (" REIS 


rintScoreCentered (NumberOfBufferHits[Read]); 
.£ (NumberOfAccesses[Read]>0) 
{ 
Epcontf(" m 
PrintPercent (NumberOfCacheHits [Read] +NumberOfBufferHits [Read], 
NumberOfAccesses [Read] ); 
rant f (" B). 
PrintPercent ((NumberOfAccesses[Read]-NumberOfCacheHits[Read]), 
NumberOfAccesses [Read]); 
) 


Ent f ("Mn Write Pala, 
"rintScoreCentered(NumberOfAccesses[Write]); 
Eentf(" E 

rintScoreCentered (NumberOfCacheHits [Write]); 
Entf (" E; 


rintScoreCentered(NumberOfBufferHits[Write]); 


.£ (NumberOfAccesses [Write]>0) 

{ 

mrantf (" Bs 

PrintPercent (NumberOfCacheHits [Write] +NumberOfBufferHits [Write], 

NumberOfAccesses[Write]); 

Erintf(" ejns 

PrintPercent ((NumberOfAccesses[Write]-NumberOfCacheHits[Write]), 
HE, NumberOfAccesses[Write]); 


E 
Miss "); 


Rates"); 
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DisplayReguestBreakDown 
continued 


B= 0 


* x 
Ké: 
** 
A X 
* X 
*x X 


Ve e ce e e H d H d H H de d de de He d Ke O S. 


pens E Total "5 
PrintScoreCentered(TotalNumberOfAccesses); 
parc dio 
PrintScoreCentered(TotalNumberOfCacheHits); 
oret WE 
PrintScoreCentered(TotalNumberOfBufferHits); 


if (TotalNumberOfAccesses>0) 

{ 

pelner (” " àu; 

PrintPercent (TotalNumberOfCacheHits+TotalNumberOfBufferHits, 
TotalNumberOfAccesses); 

print E (" "); 

PrintPercent (TotalNumberOfAccesses-TotalNumberOfCacheHits 

—TotalNumberOfBufferHits, 

TotalNumberOfAccesses); 


) 
Prime (n), 
DisplayReguestHistogram(); 


) 
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| 
1 DisplayRequestHistogram() 


sizeType Timelndex; 


mne £("Mn Request Time Histogram"); 

print f ("Nn + 

“or (TimeIndex=0; Timelndex<ScreenHistogramMaxIndex; Timelndex++) 
print f(" p 


brant € (" BUG "j; 

brintf("\n T 

tor (TimeIndex=0; TimeIndex<ScreenHistogramMaxIndex; TimeIndex++) 
printf(" E 

| 

int € ( Access"); 

ENDE f ("An uy 


tor (Timelndex-0; TimeIndex«ScreenHistogramMaxindex-1; TimeIndex++) 
| i 
prantf(" Time="); 
PrintSize2 (Timelndex); 
} 
MINE E(" Time>="); 
rintSize2 (TimeIndex); 
ment. f (" Total Time "); 


ek k k k k e e e kok k ADD DR A ORA R 


* * 


* c 


* * 


kk 


** 


* *x 
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Display.c ky 

** 

DisplayReguestHistogram Lg 
continued 6 


* + 


e ce ede de e e oe e ee e de H H d de H d H d d H T L a 


printf ("n Read "); 
for (TimeIndex=0; TimelIndex< (ScreenHistogramMaxIndex-1); Timelndex++) 
i 
print E (E 
PrintScoreCentered (RequestTimeHistogram[Read][TimeIndex]); 
} 
pednt £ (0); 
PrintScoreCentered(LastScreenHistogramScore (RequestTimeHistogram[Read])); 
SE Or; 
PrintScoreCentered(TotalRequestTime[Read]); 
printed). 
PrintAveAccess (TotalRequestTime [Read] NumberOfAccesses[Read]) ; 


print E (im Woite M 

for (TimeIndex=0; TimeIndex<{(ScreenHistogramMaxIndex-1); TimeIndex++) 
{ 
princi 255 
PrintScoreCentered (Request TimeHistogram[Write] [TimeIndex]); 
) 

DE int fico, 

PrintScoreCentered(LastScreenHistogramScore (ReguestTimeHistogram(Write])); 

EE 

PrintScoreCentered (TotalRequestTime [Write] ); 

prints 

PrintAveAccess (TotalRequestTime[Write],NumberOfAccesses[Write]); 


printed n Ideal "); 

for (TimeIndex-0; TimeIndex«(ScreenHistogramMaxIndex-1); Timelndex++) 
{ 
DE nt a, 
PrintScoreCentered (Request TimeHistogram[None] [TimeIndex]); 
} 

print sl) 

PrintScoreCentered(LastScreenHistogramScore (RequestTimeHistogram[None])); 

prints le 

PrintScoreCentered (TotalRequestTime [None] ); 

EE E 


) 


RRA k kx k x x+ x x x x kx x x x x+ x x x x x x x Xx dece ce ee x x x x x x+ xk x+ x x x k xk x x k x x x RR LT HA 
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Display.c SE 

* A 

DisplayStallHistogram Aw 


* + 
ME E E E EE EE de de d de E EE ee e ek de e e ede de d de de de de de e dede ee ee e e / 


| DisplayStallHistogram() 


| 


ic lLype TimeIndex; 
'acheWaitingForType StallIndex; 


ystem(ClearScreen) ; 


ent f ("\n\n Stall Time Histogram\n\n") ; 
mantf (" B 
or (TimeIndex=0;TimeIndex<ScreenHistogramMaxIndex-1;TimeIndex++) 
{ 
printf(" Time="); 
PrintSize2 (TimeIndex); 
) 
rintf(" Time>="); 
rintSize2 (TimeIndex); 
mEntf(" dotal\n"); 
Mati ("An"); 


or (StallIndex=0; 
StallIndex<NumberOfCacheWaitingForsAvailable; 
StallIndex++) 
{ 
PrintWaitingFor (StallIndex); 
for (TimeIndex=0;TimeIndex<ScreenHistogramMaxIndex-1; TimeIndex++) 
{ 
Seamer (" "); 
PrintScoreCentered (Stall TimeHistogram[StallIndex] [TimeIndex]}); 
} 


Brintf(" E 

PrintScoreCentered(LastScreenHistogramScore (StallTimeHistogram[StallIndex])); 
Brintf(" m; 

PrintScoreCentered(TotalStallTime[StallIndex]); 

Entf ("Win"); 

) 


f CK k k k k k k k k k * k ke k k k k k k k k k k k k k k k xk k xX k d x X XXX XX XXX XXX XXX e e X dk k kkk kkk kk kk kk kk kk 


** 


** 


* * 


de de 
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Display.c 


LastScreenHistogramScore 
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** 


* * 


* * 


X + 


* x 


ck ek de ke de e e e ke e ek e de He e ke e ke ke e kk ek IE he e e de de e ek ek ke e ek ek e ek ek RE e e dee ke e ke ke ek dee e RR] 


ScoreType LastScreenHistogramScore (Histogram) 


TimeType *Histogram; 
{ 


TimeType  TimeIndex; 
ScoreType Sum=0; 


for (TimeIndex-ScreenHistogramMaxIndex-1; 
TimeIndex<FileHistogramMax Index; 
TimeIndex++) 
Sumt-Histogram[TimeIndex]; 


return(Sum); 


AA AXX KX XXX X XX X X X XX XX X XX X X KX X K X A AN XX X KX KX AA N+ kK K AAA A+ AKA AA AA AAA AA AAA AAA AA A 
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Display.c 2 


** 


DisplayCacheArguments s 


* X 


e ke e ee kk e e e d d e de de de de de d de de de de de de de de de de de de de de de de de e de de de e de de de de de de $ d % det / 


\ 
| DisplayCacheArguments () 


| 


ystem (ClearScreen) ; 


t f£ ("Nn"); 

mint f(" 

Rent É ("An"); 

net ("AnCache Size: 
EEncf£(" ORE 
rintf ("Read Forward: 
mame ft ("AnBlock Size: 
ant f (" Mei 


rintf("CPU Waits For Cache Writes: 


vint f ("\nSubBlock Size: 

nt f(" B 
rintf("Search Block Buffer: 
Meet (" \NASsociativity: 

Ant £ (" E 

rintf ("Update Read Buffer: 
rintf("\nWord Size: 

Een t f (" s), 

rintf ("Remove Read Duplicates: 
rintf("\nRead Cache Access Time: 
Bent (" WI 

rintf("Remove Write Duplicates: 
rintf("\nRead Cache Hit Time: 
BEEntf(" D. 

REI ("Read Priority: 
rintf("\nRead Cache Miss Time: 
ent f (" éi 

MEE ("Write Priority: 
rintf("\nWrite Cache Access Time: 
Wir 7 ("7 My 

rintf ("Read For Write Allocate: 


Cache Arguments List"); 
"); PrintCacheSize (CacheSize); 


"); PrintYesNo (ReadForward); 
"); PrintSize(BlockSize); 


"); PrintYesNo(CPUWaitsForCacheWrites); 
Wee Pint Size (SUbBIlGeksi ze, 


SEET ECH 
EE A Eelere 


"); PrintYesNo (UpdateReadBuffer); 
"); PrintSize (WordSize); 


"); PrintYesNo (RemoveReadDuplicates); 
"); PrintTime (ReadCacheAccessTime) ; 


T); PrintYesNo(COBeUsveWritebüprPreadtes); 
"); PrintTime (ReadCacheHitTime); 


WEE EE TE 
"); PrintTime (ReadCacheMissTime) ; 


EE EE 
"); PrintTime (WriteCacheAccessTime) ; 


"); 


RrintPriority (ReadForWriteAllocatePriority); 


rintf("\nWrite Cache Hit Time: 
hunt f (" 2) 


mmet( Write Dirty Block Priority: 


"); PrintTime(WriteCacheHitTime) ; 


H 


MeenerPriority (WriteDirtyBlockPriority); 


rintf("\nWrite Cache Miss Time: 
ment f (" ys 
Meer ("No Priority: 


a ere Prime (Wrerte@acheouics hinge), 


EE 


f Coe dee dee dede de dede k de d de de de k de de de de heck E 


* * 
de dk 
* x 
kk 
* * 


kk 
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DisplayCacheArguments 
continued 


** 
* * 
* Xx 
kk 
** 


** 


e se se de de je k k E OND DESERTO A e 


printf ("XnMemory Access Time: 
printi 1907 

print f("Trace: 

printf ("inMemory Transfer Time; 
print G do dor 
print f (“Cheek: 


printi(‘\nBuffer Cache AcGÉS Sie: 


pen 2) 

printf Test: 

printf ("XnRead Buffer Size: 
print. n) 
printf ("Key Board Irdi 

printf ("inWrite Buffer Size: 
print fi s 
printf (“Data File Name” 


printf("\nBlock Replacement Policy: 


"); PrintTime (MemoryAccessTime); 


"); PrintYesNo (Trace); 
"); PrintTime (MemoryTransferTime) ; 


"); PrintYesNo (Check); 
"); PrintTime (BufferCacheAccessTime); 


"); PrintYesNo(Test); 
"); PrintBufferSize (ReadBufferSize); 


"); PrintYesNo (KeyBoardIl1O); 
"); PrintBufferSize (WriteBufferSize); 


$s",DataFileName) ; 


E 


PrintReplacementPolicy (BlockReplacementPolicy); 


promitto 25 
printf("Screen History Max Index: 


ER 


PrintHistogramindex (ScreenHistogramMaxIndex); 


printf("\nWrite Policy 
print Ft" p 
printf("rile Historia Index 


"); PrintWritePolicy (WritePolicy); 


"da 


PrintHistogramIndex (FileHistogramMaxIndex) ; 


printf("\nWrite Miss Policy: 


"); 


PrintWriteMissPolicy (WriteMissPolicy); 


print (ne 


} 


e 3 Kk * e che ke ce ee ce RAR k Kk TH * * 


Page 
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DisplayHelp 


39-17 


* * 


kk 


kk 


** 


* * 
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 DisplayHelp() 


ystem (ClearScreen); 
rintf(" Help Menu 


Emtf ("Nin"); 
emer (‘\n [T] Trace Display: 


Entf ("Wn Displays current request, status of memory, and contents 


Entf ("An of buffers. 

| 

tf ("in"); 

Kant f ("\n [R] Results Display: 

nt f ( " Xn Displays a break down of read and write cache hits, 
gnt f (" \n buffer hits, including a timing analysis. 


ER ("1n"); 
tg [S] Stall Timing Display: 


and 


gent f (" \n Displays a histogram of the time spent on each stall. 


ent f("\n Stalls represent time delays in completing a request 


cintf("\n"); 


kintf("\n [C] Cache Arguments Display: 


Euntf ("An Displays input arguments to SACS. 
BEBE f ("Nn"); 

ENDE E ("\n [G] Go: Go to end of run. 
rintf("\n [G +] Go To: Go to Time #. 

cintf ("Nn [#] Step: Increment Time By #. 
cintf("\n [-#] Back Step: Decrement Time By #. 
Emtf("Wn [H] Help: Displays this help menu. 
BEE (hn 


"Ja 


T es 
2557 


n 


H 
ee 
ae 


Dj 


GŒ 


S 


t 


"); 
"); 
"); 
Kr 
a Er 
"Ja 


f ee ee de e hee sehe eer EE EE X X XY e A 


* 

* + Display.c 

xt 

** DisplayTestingHeader 
* X 


Page 


8= 18 


** 


kk 


Xx 


* + 


* * 


eee He d d d de H e dk ok EI aa ee ee 


void DisplayTestingHeader() 


{ 


printf CAT 
system(ClearScreen); 
print É ("am"); 


prime ( " \n249 "); 
propere Testing SACS"); 
print f ("\n\n 1); 


printf("Total number of loads and stores tested %lu.", 
TotalNumberOfAccesses); 

princi mu ur 

primer(" Test Cases chosen ... "); 

primeti (nn); 


} 





Basplay.c 


Print Enumeration Stings 


EXA AA A AAA AAA AAA X X X X X K k k k X K X X kK x x x x kx « x *x * kx x *x xk k x *x x x x x x *x *x* x x x x x x AT 


** 


** 


** 


kk 


** 


MEM ooo X OX oo de e e ke e e e e e e he e de e e ee hee e ehe dee e de de de de e e de de e ee de de de de e ke e e ke ke kee y 


1 PrintYesNo (Value) 
fesNoType Value; 


| 
wwéntf("%s", YesNoString[Value]); 


4 
| 

^ 
` 





1 PrintRequest (Value) 
tequestType Value; 
H 


orintf("£s",RequestString[Value]); 


1 PrintReplacementPolicy (Value) 
3lockReplacementPolicyType Value; 


brintf("%s", ReplacementPolicyString [Value]); 
1 PrantWritePolicy (Value) 

pmecePOlicyType Value; 

»rintf "$s", WritePolicyString[Value]); 

i PrintWriteMissPolicy (Value) 
JriteMissPolicyType Value; 

unit ('"%s",WriteMissPolicyString |Valuel|); 
ll rintWaitingFor (Value) 

EENneWartingForType Value; 


Entf("$s",CacheWaitingForString[Value]); 


i PrintMemoryWaitingFor (Value) 


lemoryWaitingForType Value; 
)intf("£s",MemoryWaitingForString[Value]); 
HEPrintBlockWaitingFor (Value) 


JlockWaitingForType Value; 


EEntf('"$s",BlockWaitingForString([Value]); 


f * ke nece K e H k k aaa aa E E AAA WAA WAA LL 


** 
X X Display.c 
* * 


* c Print Routines 
k Ak 
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** 


de de 


x + 


kA 


** 


dece H H H H kok k k O n 


void PrintTime (Time) 
TimeType Time; 
{ 
af (Time>=10000000) printf("%8lu",Time); 
else if (Time>=1000000 ) printf("£71lu ",Time); 
else if (Time>=100000 ) printf("%6lu ",Time); 


else if (Time>=10000 ) princi ss lo ", Time); 
else if (Time>=1000 ) printf ("%4lu ",Time); 
else if (Time>=100 ) printi 3lü ",Time); 
else if (Time»-10 JZ PE DNE 2) ", Time); 
else pe me T " Time); 


} 


void PrintTimeCentered (Time) 
TimeType Time; 
{ 


YE (Time>=1000000) printf("$8lu",Time); 
else if (Time>=10000 ) printf("$71u ",Time); 
else if (Time>=100 princi: STIME); 
else Printi zlu ",Time); 


} 


void PrintScoreCentered (Score) 
ScoreType Score; 
{ 


THE (Time>=1000000) printf("%8lu", Score); 
else if (Time>=10000 ) printf("$71u ",Score); 
else if (Time>=100 ) printf("$60lu "¿Sere 
else pranzo] ", Score); 


) 


void PrintAddress (Address) 
AddressType Address; 
{ 
printf ("%081X",Address); 
} 


void PrintCacheSize (CacheSize) 
CacheSizeType CacheSize; 


{ 
printf ("308lu", CacheSize); 


) 


void PrintSize (Size) 
SizeType Size; 
{ 
printf( s05u 752 ze); 


) 


void PrintSize2 (Size) 
SizeType Size; 
{ 
printf (2024 ae), 


) 


K +Á A+ +k k xk k k k xk xk k x x x xk x x x x x x x x x x x x xk k k x kx x x x x kx x k kx *x kx x kx *x kx Ak kk kk kk kk kk A kk Ak * kk kk kk Ak d * 


Display.c 


Print Routines 
continued 


** 


* * 


de * 


A de 


* * 


* * 


Ne e e E A Ee / 


ErintBufferSize (BuffersSize) 
üfferSizeType BufferSize; 





cintf ("$02u”, BufferSize); 


| PrintPriority (Priority) 
Nri)tyType Priority; 





rintf ("$02u",Priority); 


PrintAssociativity (Associativity) 


bsociativityType Associativity; 


| 
| 
met ("502u",Associativity); 


PrintHistogramIndex (HistogramIndex) 
istogramIndexType HistogramIndex; 
| 


cintf ("$04u", HistogramIndex); 


] * K * * * *K * * H * H H dH d d H d dc He de de He de de H Ke de TTT L ER d 


** 


* * DISPTAY.C 
+ A+ 

* * Print Routines 
* * continued 


* * 


Page 


8522 


* ok 
* * 
** 
X + 
* * 


* * 


Re KR KK dk S.. d Cd a LL 


void Printere BIT) 
YesNoType Bit; 
{ 
printf ("30M Bit 
} 


void PrintPercent (Numerator,Denominator) 
ScoreType Numerator; 
ScoreType Denominator; 
{ 
if (Denominator>0) 
{ 
printf ("%6.21f£", (100. 0*Numerator) /Denominator), 
PENES. 
) 
else 
{ 
Printi Dr 
} 
} 


void PrintAveAccess (TotalTime, TotalNumberofAccesses) 
TimeType TotalTime; 
ScoreType TotalNumberofAccesses; 
{ 
if (TotalNumberofAccesses>0) 
{ 
printf("%8.61f", (1.0*TotalTime) /TotalNumberofAccesses); 
) 
else 
{ 
printf ker 
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Record.c 


Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Euthor: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


m“—.ont 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 


Page 


20 


its documentation for any purpose and without fee is hereby granted 
E ded that the above copyright notice appears in all copies. 
modified version of this program should be redistributed without the 


authors consent. William G. Smith makes no warranty or 


NO 


Bepresentation, promise of guarantee, either expressed or implied, 


wn respect to this software's ability to produce valid results. 


RES program is provided "as is" any financial, personal or property 


damage caused by the use of this program is the responsibility of the 


user. 
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kk 
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** 
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k k 


k k 


* o 


k k 


** 


x* 


* * 


* k 


* * 


* * 


kk 
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* x 


k k 
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— eS... 


foe ee e e e e ee k de e ke e k O.. 


** 


* x 


** 


** 


kx 


** 


** 


* Xx 


** 


* * 


** 


x* 


** 


* * 


* * 


* + 


* * 


* ok 


kecora se 


Description: 


Table of Contents 


Cover Page sace. e c ELE EM c Page 
List of Record.c Function Declarations .... Page 
RecordRequest () «un 735W: 
Recordsta 0) eee ER EE Page 
RecordForMat lab) ZC ege eee Page 


Page 


~d Ln LG A A 


9— 


Record.c contains all functions that relate to the recording of 
time for reguests, and waiting fors, as well as a procedure for saving 
the data in a file using a format that Matlab (TM) could read. 


Ji 


* + 
** 
* * 
* + 
* + 
* * 
* * 
* * 
* * 
* x 
* x 
** 
* * 
* * 
** 
* x 
* x 


* x 


DE IE ke e e e Ï d H e e e H e e ke e H e de de e ate e ate ale He e e e ehe cede ee ee de e ee K d K e de e ee dece e de e e e ee e d de K e ke de ke e e ke e ke ke ke x / 


#include 


"Global me" 








Record.c 
List of Record.c Function Declarations 


Weription : 


t "Record.c". 


RecordRequest (); 
RecordStall(); 


RecordForMatlab(); 


*k*k*k*k* x k k k xk k x xk xk x Xx x x x k x+ x x x k kk 


Page 9- 2 ** 


A de 
** 
* + 
* + 
* * 


* ok 


This is a list of function declarations within the file scope SES 


* * 
* * 


kkk k k k k k k k k k k k k k k k k k k % k k he k k e k % k k ke k k X XXX XXX X XXX XXX X XXX XX XX X % e k x e e i 


/ Page 9- 3 */ 
/* Page 9- 5 */ 
/* Page 9- 7 */ 
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a Page 99 
AA Record.c SCH 
** ** 
Se Record Reguest * * 
* A * + 


** Description: * x 


** ae 
YA RecordReguest records the time spent on a particular reguest and Zë 
** Stores the result in RequestTimeHistogram. * x 
** x 


de de de K de de de RON de de de de de de de de de de de de de de de de K He de de de e de K de Dk Ok kk de de de de de de ke ke de K kk kk ck kk ke de de de K e ke ke e e kk ke ee / 


void RecordRequest (Req) 
RequestType Req; 


{ 


static TimeType LastTime=1; 

static TimeType Lastdt=0; 

static RequestType LastReq=NumberOfRequestsAvailable; 
TimeType dt=Time-LastTime; 


if (Req==NumberOfRequestsAvailable) 
{ 
LastTime=1; 
Lastdt=0; 
LastReg=Reg; 
) 
else if (Reg==LastReg) 
{ 
TotalReguestTime [LastReg]-=Lastdt; 
if (Lastdt>FileHistogramMaxIndex-1) Lastdt=FileHistogramMaxIndex-1; 
RequestTimeHistogram[LastReq] [Lastdt]--; 
) 
else if (LastReg!=NumberOfReguestsAvailable) 
1 
LastTime=Time; 
dt=0; 
NumberOfCacheHits [LastReg]+=CacheHit; 
NumberOfBufferHits [LastReq] +=BufferHit; 
) 


Lastkea-Reg; 


Sama Wa de i 


dA Ak Ak kk kk k k kk kk X X K K X K A A A A A A AA A AA AA A K X K X X k K k + A+ + k kk k + k + A+ +k k + + k kk kk k A+ x+ * A+ k + k A+ 
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x * 

Record Request p 
continued d 


** 


k CC oki de d de H Ke de de He d H de He de de H He de H H e he e dee de ehe e / 


( 
TotalRequestTime [Req] +=dt ; 
Lastdt=dt; 
if (dt>FileHistogramMaxIndex-1) dt=FileHistogramMaxIndex-1; 
if (Time>=LastTime) 
{ 
ReguestTimeHistogram[Reg] [dt]++; 
) 
else 
{ 


sn inError (RecordReguest] caculated a time less than 0"); 
gE Int íf ("\n\n Time = "); PrintTime(Time); 

| bene (*\n\nLastTime = "); PrintTime(LastTime); 

passer ("Nnin") ; 

DiscrepancyFound-Yes; 


) 


) 

T (Req!-NumberOfRequestsAvailable) 
| 

| 

| 

í | 

| 

] 


| K E He e e REC Eee de de AO RE ER T E T T EA AA A A AA A A A k+ k + + k X + X A + + 


x* 
* + 
* dk 
** 
* * 
* * 
* XÀ 
** 
* * 


* * 
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RecordStall 


Description: 


RecordStall records the time spent on a particular waiting for and 


stores the result in StallTimeHistogram. 


5 


** 


** 


* * 


** 


** 


** 


** 


* + 


* A 


** 


ecc ee ke de eoe k k ok de de de k k k k O. 


void RecordStall (CurrentWaitingFor) 


CacheWaitingForType CurrentWaitingFor; 


{ 


static TimeType PastTime-1; 

static TimeType Pastdt=0; 

static CacheWaitingForType PastWaitingFor=None; 
TimeType dt=Time-PastTime; 


if (CurrentWaitingFor--NumberOfCacheWaitingForsAvailable) 
{ 
PastTime-1; 
Pastdt=0; 
PastWaitingFor=CurrentWaitingFor; 
) 
else if (CurrentWaitingFor--PastWaitingFor) 
{ 
TotalStallTime[PastWaitingFor]--Pastdt; 
if (Pastdt>FileHistogramMaxIndex-1) Pastdt=FileHistogramMaxIndex-1; 
StallTimeHistogram[PastWaitingFor] [Pastdt]--; 
) 
else if (PastWaitingFor!-NumberOfCacheWaitingForsAvailable) 
{ 
Past Time=Time; 
dt=0; 
) 


PastWaitingFor=CurrentWaitingFor; 


`... wwe = r > 






| Page 9- 6 


Record.c 


RecordStall 
continued 


| 
df (CurrentWaitingFor!-NumberOfCacheWaitingForsAvailable) 
' 3 
i TotalStallTime [CurrentWaitingFor]+=dt; 
| Pastdt=dt; 
Nf (dt»FileHistogramMaxIndex-1) dt-FileHistogramMaxIndex-1; 
| if (Time»-PastTime) 
| { 
StallTimeHistogram[CurrentWaitingFor] [dt]++; 
) 
else 


{ 
printf("\n\nError [RecordStall] calculated a time less than 0"); 


firme £ ("\n\n Time = "); PrintTime (Time) ; 
Penice (‘\n\nPastTime = "); PrintTime(PastTime); 
Premere ("nin"); 

DiscrepancyFound=Yes; 


) 


SK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK * * * * * * * * * * * * * * * * * * * 
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* + 


* + 


** 


** 


** 


| l x Eo Oo e e ecce dece ode dece e K de de e he de ehe he K 3 de de e H H H d e e eee e e % e ede e dee e / 
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* * 


* * 


* * 


* ok 


* * 


* * 


** 


** 


* * 


A x 


Rage 9- Ja 


* * 


Record. CG + + 
** 
RecordForMatlab X X 
* * 
Description: * + 
** 
RecordForMatlab saves the ReguestTimeHistogram, and do 
StallTimeHistograms in a format that Matlab(TM) reconizes. ** ! 
| 
2 


c e e ke e e ke ee eee K K d he he ee k k k.. 


void RecordForMatlab() 


{ 


CacheWaitingForType StallIndex; 
RequestType Request Index; 


int Column, | 
NumberOfColumns=2; | 


HistogramIndexType HistogramIndex; | 
FILE *MatlabOut; 


if ((MatlabOut-fopen("timing.m","w"))--NULL) 
{ 
printf ("Can not open matlab output file."); 
} 


for (RequestIndex=0; RequestIndex<NumberOfRequestsAvailable; Request Index++) 
{ 


fprintf (MatlabOut," "$s-[",RequestString[RequestIndex]); 
fprintf(MatlabOut," £081u",RequestTimeHistogram[kequestIndex][0]); 


Column=1; 


for (HistogramIndex=1; 
HistogramIndex<FileHistogramMaxIndex; 
HistogramIndex++) 
{ 
Columns +; 
if (Column»NumberOfColumns) 
{ 
Columns; | 
fprintf (Mat labou An E 
) 
else 
d 
fprint f (Mal labour? E 
} 
fprintf (Mat labou a eO 
RequestTimeHistogram[RequestIndex] [Histogramrndex]); 
) 


fprintf (Mat labourt I mE 


} 


DA A AAA AA A A AAA A AA A A RA AA A A A AA A A x xk X k k + k X k kX k k+ k X k A+ x x x *kx x x xk *x x x x x x x x x + *x *% x kx x *x x A+ * A+ d+ * * 
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* x 

RecordForMat lab X X 
Continued * k 

x * 





bebe, 


for (StallIndex=0; StallIndex<NumberOfCacheWaitingForsAvailable;StallIndex++) 


{ 
at laboOut, "4s=[",CacheWaitingForStringf[Stalllndex]); 
Berit. (MatiabOut," $081u",StallTimeHistogram[StalllIndex][0]); 


Column=1; 


<<<, Z 


for (HistogramIndex=1; 
HistogramIndex«FileHistogramMaxIndex; 
HistogramIndex++) 


( 
mt; 
if (Column»NumberOfColumns) 


{ 

Column=1; 

print £ (Matlabout, ", Mn DE 
) 


else 
{ 
lint E (Mat labOut,","); 
} 


Beemer (MatlabOut,” £081u", 
SrtallTimedistogram[StallIindex] [Histogramindex]); 
) 


gmimtrf(MatlaboOut, "Jj? nn"); 
} 
Eclose (MatlabOut) ; 


| 
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* c 
* ck 
* * 
* + 
* x 
** 
* * 
* % 
* % 
** 
* * 
* * 
* * 
** 
A * 
* * 
** 
A + 
+ + 
** 
kk 
** 
* + 
** 
** 
** 


** 


Buffer C 


Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, William G. Smith 
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Permission to use, copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies: 
modified version of this program should be redistributed without the 


authors consent. William G. Smith makes no warranty or 


representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 
This program is provided "as is" any financial, personal or property 


damage caused by the use of this program is the responsibility of the 


set: 


* * 
** 
xx 
** 
A de 
* X 
** 
* X 
* * 
** 
* * 
** 
** 
A de 
** 
** 
x* 
** 
de de 
A de 
* ck 
de de 
x + 
de + 
* + 
* + 


** 
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BÚBRSE.C K * 

* * 

Description: A 
X + 

| M c contains all functions that relate to the management of Se 
the Read, Write, and Block Buffers. * A 
* * 

(Aveo Contents tx 

* x 

c... ERR Page 10- 1 iX 
| Mee of Cache.c Function Declarations ..... Page 10- 2 ** 
| Br Page T0=>3 S 
| EEUU ae R IR RR IG Page 10- 4 SS 
| EU NSUopMemoryRequest() .................. Page 10- 5 YA 
| EE .................--- RR a Page 10- 6 x 
| EE. RII cee Page 10- 7 * + 
| MM oe eee rr IR RI R B Page 10588 A 
| EEN Page 10- 9 s 
| Br Page 1010 aði 
| WEI ee ee eee IRR RR Ke Page 10-12 ** 
| NINE ReEadButier() ...................... Page 10-13 GEN 
| E © CSC) ......................... Page 10-15 o 
| RR wcstsbeft() .......................... Page 6 Xx 
| * * 


ME M / 


iclude "Global.h" 


A E E A A 


RE Page 10.72 
a BUECEr. C 

** 

n List of Buffer c Function Declaratilons 

* * 

** Description: 

** 

A This is a list of functions declarations within the tilesscops 


** of "Buffer O= 


** 


* + 


** 


** 


X + 


Xx * 


* * 


* * 


* + 


* * 


** 


*k * H K H *« * H ke ee * H H d d de de hee eoe ek WA EEN 


void 
MemoryRequestType 
void 

void 
MemoryRequestType 
void 

void 

void 

YesNoType 
YesNoType 

void 

YesNoType 


Push (); 

Pop(); 
ChangeTopMemoryRequest (); 
Append (); 

View (); 

Clear (); 

Order (); 

Splice (); 

Search(); 
UpdatingReadBuffer (); 
RemoveZeroSizes(); 
NoRequestsLeft (); 


Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
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*+*k*k k k xk k k k xk k k x xk k kx k kx x k k x x x k kx x kx x k x x x x x x x x x x x eoe oce oe oce oe ce ce oe oce ck oe ck oce oe oe ce * k kx * * x kx ce ck coke ck oe ce ook oko 


Cage 0 3 > 


— Ps = 





d Buster sc *k k 
| * * 
Push * ok 

* * 

Description: * + 

* * 
| Push adds a new record to the top of the buffer. * * 
| * * 
l K ok kk kk k k kx k k x kx k x Xx k k k k x k x x x x x / 


-d Push (Buffer, MemoryRequest) 


BufferType *Buffer; 
MemoryRequestType *MemoryRequest; 


d 


BufferSizeType 1i; 
| 
EN (Buffer->Full) 
{ 
CacheWaitingFor-Buffer-»WaitingForFlag; 
) 
else 
{ 
lE Butfer->Next; 1>0; i--) 
Buffer-»MemoryRequest[i]-Buffer-»MemoryRequest[i-1]; 
Buffer->Next++; 
Buffer->MemoryRequest [0]=*MemoryRequest; 
1f (Buffer->Next>Buffer->Max) Buffer->Full=Yes; 
Buffer->Empty=No; 
if (CacheWaitingFor==Buffer->WaitingForFlag) CacheWaitingFor=Nothing; 


) 


M —  —— 


J] ok ohe ok ok je de e e de de de de e de he de hee ec ee e he che he he de de de dc EEGEN 


de * 


* A 


* 


** 


* * 


* * 


kk 


** 


* * 


** 


Buffer.c 
Pop 


Descripc26n: 


Rage 107 4 


Pop removes a record from the top of the buffer, and returns it to 


the caller of the function: 


** 
* * 
* + 
x * 
* * 
* * 
* * 
* * 
* + 


* * 
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MemoryRequest Type Pop (Buffer) 


Buffer iype “Buffer; 


{ 


MemoryRequestType MemoryRequest; 
BufferSizeType i; 


if (Buffer->Empty || Buffer->Next==0) 
{ 
print Ena Tryed to Pop an empty buffer!inin"); 
exit (1); 
) 
else 
{ 
MemoryRequest=Buffer->MemoryRequest [0]; 
for (i0; x«Buffer- Next; T4131) 
Buffer-»MemoryRequest[i]-Buffer-»MemoryRequest[i-*1]; 
Buffer-»Next--; 
if (Buffer->Next==0) Buffer->Empty=Yes; 
Buffer->Full=No; 
) 


return (MemoryRequest) ; 


} 
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| 
J 
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Buffer.c 
ChangeTopMemoryRequest 
Description: 


Push adds a new record to the top of the buffer. 
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* * 


* * 


* * 


Xx 


* * 


* x 


** 


* * 


** 
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id ChangeTopMemoryReguest (Buffer, MemoryRequest) 


BufferType *Buffer; 


| MemoryRequest Type *MemoryRequest; 


{ 


if (Buffer->Empty==No && Buffer->Next>0) 
O Request [0]-*MemoryRequest:; 

E 
Eus Tryed to Pop an empty buffer!MnMn"); 
E 


f o k ke k de ke de de de k de ke e de d d T eee 


+ + 


* + 


* + 


** 


** 


* * 


* * 


** 


* * 
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Append 
Description: 


Append adds a new record to the bottom of the buffer. 


* * 


* * 


* * 


** 


* * 


* * 


* * 


* x 


* * 


ok O e ee eee de dece ee KK aa AWA AA E WA 


void Append (Buffer, MemoryRequest) 


BufferType *Bufter; 
MemoryRequestType *MemoryRequest; 


{ 


if (Batter—-Fult) 
{ 
CacheWaitingFor=Buffer->WaitingForFlag; 
) 
else 
{ 
Buffer->MemoryRequest [Buffer->Next ]=*MemoryRequest ; 
Buffer->Next++; 
if (Buffer->Next>Buffer->Max) Buffer->Full=Yes; 
Buffer->Empty=No; 
if (CacheWaitingFor==Buffer->WaitingForFlag) CacheWaitingFor=Nothing; 
} 


Butter .c 
View 


Description: 


altering the buffer. 





oryRequest Type View (Buffer) 


BufferType *Buffer; 


{ 


j 


MemoryRequestType MemoryRequest; 
| 


Er (Buffer-^Empty) 
mE í 





exit (1); 

) 

else 

I í 
MemoryRequest-Buffer-»MemoryRequest [0]; 

) 


return (MemoryRequest) ; 


) 


View returns a Copy Of the top record in the buffer without 


pete ("Anin Tryed to View an empty buffer!inin"); 


kk k+ k **x* k x xk x x xk kx x x k * x xk xk x x x x xk x x xk x x x x x x x x x x x x x x x x x x x x x xy x x xk A A A K AAA AA A A A A A + X X + X de + A 
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de de 


kk 


* k 


kk 


A de 


de de 


* ok 


d x 


* de 


* + 
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** 


* * 


* ck 


* X 


* X 


** 


A X 


*x* 


* * 


Buffer.c 
Clear 
Description: 


Clear removes all entrees in the buffer. 
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** 
A * 
* * 
* * 
* X 
* + 
** 
* * 


xx 


eee ee ke e e e de de d O k O. 


void Clear (Buffer) 


BufferType *Buffer; 


{ 

Buffer->Next=0; 
Buffer->Full=No; 
Buffer->Empty=Yes; 
} 


ema man am 
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Butfer c ds 

kk 

Order x * 

** 

Description: dea 
* * 

Order sorts all of the entries in the buffer by priority such SES 


| that the highest priority (lowest priority number) is at the top. A 


* * 


en A TAKA AKKAKAKKAKKKKKKKKAKKKKKKKKKAKKKKKAKKKKKKKKKKKKKKKKKKKKKKKKKK / 





id Order (Buffer) 


#BufferType *Buffer; 


{ 


- MemoryRequestType TmpMemoryRequest; 
. YesNoType Change-Yes; 
BufferSizeType Jn 


while (! (Buffer->Empty) && Change) 
{ 
Change=No; 
ir (i=Buffer->Next-1l; i»0; i--) 
{ 
if (Buffer->MemoryRequest [1] .Priority< 
Buffer->MemoryRequest [i-1] .Priority) 
{ 
TmpMemoryReguest=Buffer->MemoryReauest [i]; 
Buffer-»MemoryRequest[i]-Buffer-»MemoryRequest[i-1]; 
Buffer-»MemoryRequest[i-1]-TmpMemoryRequest; 
Change=Yes; 
) 


fee e e dede de de e e k k kok k A LLL 


* * 
* * 
** 
kk 
* * 
++ 
** 
** 
* * 
* * 
* * 
* * 
* * 
k* 
* * 


** 
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Butfter.c 


Splice 
Description: 


Splice is buffer utility that takes a one byte memory reguest and 
enters it into a buffer if the buffer does not already have the byte. 
Splice will first searchthe ReadButfer for the byte 1f it can tikin 
request in the buffer that contains the byte then it will search for à 
memory request that has data from the same block. If one is found 
then the request is modified to include the new read byte request. 

If no suitable request can be found then Splice will add a one byte 
memory request to the Buffer. 


* * 
* ck 
* * 
de ée 
kk 
** 
* * 
* * 
de de 
* * 
** 
* * 
* + 
* * 
* * 


* xk 


dee oe e e e che de ke eene ee ee ek dc de de de kk ck oko kk OK CK X Kok ck ck ckokck ck kokock x KE cKkok ox cct I LLLOOÓI 


void Splice(Buffer, Address, ReguiredSize,Block,Priority) 


BufferIype BUTLER: 
AddressType Address; 
S1ze€Type RequiredSize; 
SizeType Block; 


Priority lyoe Priority; 


d 


BufferSizeType BufferIndex; 

YesNoType FoundByte=No; 

AddressType FrontAddress; 

AddressType BackAddress; 

AddressType CurrentBlockAddress-BlockAddress (Address); 
SizeType NextSize; 


MemoryRequestTypé Meroryrequest; 


MemoryRequest.Address = Address; 
MemoryRequest.Size = `Ï; 
MemoryRequest.RequiredSize = 0; 
MemoryReguest Glock = Block; 
MemoryRequest.Priority =/ Priority; 
MemoryvRequest. Access Inbrosgness Xo 
MemoryRequest.TimeToExecute = 0; 


MemoryReguest.CompletionTimeEstimate = 0; 
if (RequiredSize»0) MemoryRequest.RequiredSize-1; 


de de de he he * x x+ k x x k x x x kx x x x x x+ x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x *x x x x x x *x x X + + 
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Buffer.c m 
de de 
Splice YA 


continued * * 
. * de 


M k A O À 


— M A 


EE (| (Buffer->Empty)) 
EN | 
| for (BufferIndex=0; BufferIndex<Buffer->Next; BufferIndex++) 
| d 
if (BlockAddress (Buffer-»MemoryRequest [BufferIndex].Address)-- 
CurrentBlockAddress) 
| { 
NextSize=1; 
FrontAddress=Buffer->MemoryRequest [BufferIndex] .Address; 
BackAddress =FrontAddress; 
while (FoundByte==No && NextSize<=BlockSize && 
NextSize<=(Buffer->MemoryRequest [BufferIndex] .Size+1)) 
{ 
if (BackAddress==Address) 
| { 
if (NextSize>Buffer->MemoryRequest [BufferIndex].Size) 
Buffer->MemoryRequest [BufferIndex].Size=NextSize; 
if (RequiredSize>0) 
Buffer->MemoryRequest [BufferIndex].RequiredSize=NextSize; 
if (Buffer-»MemoryRequest [BufferIndex].Priority»Priority) 
Buffer-»MemoryRequest [BufferIndex].Priority-Priority; 
FoundByte-Yes; 
) 
if (FrontAddress--Address && 
Buffer-»MemoryRequest [BufferIndex].AccessInProgress--No) 
{ 
Buffer->MemoryRequest [BufferIndex].Size=Next Size; 
if (RequiredSize>0) 
Buffer->MemoryRequest [BufferIndex].RequiredSizet+; 
Pfo(Buffer-»MemoryRequest[BufferIndex]-Priority»Priority) 
Buffer-»MemoryRequest [BufferIndex].Priority-Priority; 
FoundByte-Yes; 
} 
NextSizett; 
if (NextSize>Buffer->MemoryRequest (BufferIndex] .Size) 
FrontAddress--; 
BackAddress++; 
if (BlockAddress (FrontAddress) !=CurrentBlockAddress) 
FrontAddress+=BlockSize; 
if (BlockAddress (BackAddress) !=CurrentBlockAddress) 
BackAddress-=BlockSize; 
) 
if (Buffer->MemoryRequest [BufferIndex].Size==BlockSize && 
Buffer->MemoryRequest [BufferIndex] .AccessInProgress==No) 
{ 
Buffer->MemoryRequest [BufferIndex] .Address=RequestAddress; 
Buffer->MemoryRequest [BufferIndex] .RequiredSize=Request Size; 
} 





} 
| ) 
if (FoundByte--No) Append (Buffer,&MemoryRequest); 


f ek ee de dede ce deje de e k de de de e de de de de de e ek kk ook aa A A TT T T 


* * 
de dk 
xk 
A + 
* * 
* * 
** 
* * 
* * 


* * 
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Butter „Cc 
Search 


Description: 


Search checks a buffer to see if it contains a byte addressed by 


Address. 


* * 
** 
Ké: 
* o 
* ok 
* * 
** 
A de 
* + 


Xx 


Ve Ae de de "E T T e 


YesNoType Search(Buffer, Address) 


Buf ferType *Butten; 
AddressType Address; 


{ 


BufferSizeType BufferIndex; 


AddressType ByteAddress; 

AddressType CurrentBlockAddress-BlockAddress (Address); 
SizeType NoBytes; 

YesNoType FoundByte=No; 


if (! (Bufrter-- Empr 
{ 
for (BufferIndex=0; BufferIndex<Buffer->Next; BufferIndex++) 
{ 


if (BlockAddress (Buf fer->MemoryRequest [BufferIndex] .Address)== 


CurrentBlockAddress) 
{ 
ByteAddress-Buffer-»MemoryRequest [BufferIndex].Address; 
for (NoBytes=0; 
NoBytes<Buf fer->MemoryRequest [BufferIndex].Size; 
NoBytestt) 
{ 
if (ByteAddress--Address) FoundByte-Yes; 
ByteAddress++; 
if (BlockAddress (ByteAddress) !=CurrentBlockAddress) 
ByteAddress-=BlockSize; 
) 


) 


return (FoundByte) ; 


) 


Mr se eoe oe oe oe oe oe oe ox oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe ode oe fe oe e oe oe ode oe oe oe e oe oe oe oe oe X k k X k+ X k + + k + X + + k k k k k k + k k 


Pacembo-l3 ** 


EE E e 

UpdatingReadBuffer Da 

de de 

Description: P 
| de de 
UpdatingReadBuffer takes a byte of data provided by a CPU write x> 
Eregeust and checks to see if it is needed in the read buffer. If the “ 
! byte is needed then the MemoryReguest is modified so that the byte * + 
ES no longer in the request. * * 


de de 






NoType Updat ingReadBuffer (Address) 
AddressType Address; 

È 

AddressType ByteAddress; 
“AddressType CurrentBlockAddress = BlockAddress (Address) ; 
"BufferSizeType BufferIndex; 
„YesNoType FoundByte 


| 
| 
i 


| 


| 


No; 


foe e e ee e e e e e e de de he e e ee kk AI TE AAA CLE 


* x Page 10-14 ** 
a Buffer.c ya 
** ** 
P UpdatingReadBuffer n 
SC continued X. 
SC ** 


K de ko kok kok ok ke ehe EEE ad eee 


if (! (ReadBuffer.Empty)) 
{ 
for (BufferIndex=0; BufferIndex<ReadBuffer.Next; BufferIndex++) 
{ 
if (BlockAddress (ReadBuffer.MemoryRequest [BufferIndex] .Address) == 
CurrentBlockAddress 
&& ReadBuffer.MemoryRequest[BufferIndex].AccessInProgress--No) 
{ 
if (ReadBuffer.MemoryRequest [BufferIndex].Size>0) 
{ 
ByteAddress=ReadBuffer.MemoryRequest [BufferIndex] .Address + 
ReadBuffer .MemoryRequest [BufferIndex] .Size =, 
if (ByteAddress==Address) 
{ 
ReadBuffer.MemoryRequest [BufferIndex].Size--; 
if (ReadBuffer.MemoryRequest[BufferIndex].RequiredSize» 
ReadBuffer.MemoryRequest [BufferIndex].Size) 
ReadBuffer.MemoryRequest [BufferIndex].RequiredSize= 
ReadBuffer.MemoryRequest[BufferIndex].Size; 
FoundByte-Yes; 
) 
) 


if (ReadBuffer.MemoryRequest [BufferIndex] .Size>0) 


{ 
if (ReadBuffer.MemoryRequest[BufferIndex].Address--Address) 


{ 
ReadBuffer.MemoryRequest [BufferIndex] .Address++; 


if (BlockAddress (ReadBuffer.MemoryRequest [BufferIndex] .Address) 


! -CurrentBlockAddress) 
ReadBuffer.MemoryRequest [BufferIndex].Address--BlockSize; 
if (ReadBuffer.MemoryRequest[BufferIndex].Size 20) 
ReadBuffer.MemoryRequest[BufferIndex].Size--; 
if (ReadBuffer.MemoryRequest [BufferIndex] .RequiredSize>0) 
ReadBuffer.MemoryRequest[BufferIndex].RequiredSize--; 
FoundByte-Tes,; 
) 


} 
RemoveZeroSizes (6ReadBuffer); 
return (FoundByte); 


} 


ui 


Dr 





Buffer.c 


RemoveZeroSizes 






| Description: 


the buffer. 


d RemoveZeroSizes (Buffer) 


BufferType *Buffer; 


BufferSizeType i=0; 
BufferSizeType j=0; 


while (j<Buffer->Next) 
| { 


if (Buffer-»MemoryRequest[j].Size--0 && 
IBuffer—->MemoryRequest [3] .AccessInProgress) 
{ 
j++; 
Buffer->Full=No; 
) 
else 
{ 
Buffer->MemoryRequest [i]=Buffer->MemoryRequest [5]; 
EEF; 
j++; 


Buffer->Next=i; 
1f (Buffer->Next==0) Buffer->Empty=Yes; 


} 


RemoveZeroSizes removes all entrees that have a zero size from 
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** 
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** 


kk 


* * 


* % 


* * 
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* * Page IO0-T6 "552 
X X Buffer.c x> 
** * x 
X X NoRequestsLeft da 
* * * * 
** Description: * * 
*ock *ock 
XE NoRequestsLeft returns Yes if there are no more requests left r 
** in the berr * *% 
** * * 


e che ce kok kok ko ok k AA AA WA WA 


YesNoType NoRequestsLeft (Buffer) 
BufferType *Buffer; 


{ 
BufferSizeType i; 
for (i120; i<Buffer-2Nexi do 


{ 
if (Buffer->MemoryRequest [i] .RequiredSize>0) return (No); 


} 


return (Yes); 


a 


ka 





- 
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Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Coppessoht 1994, William G. Smith 


Permission to use, copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 
Wééééééèwgram is provided "as is" any financial, personal or property 
Semege caused by the use of this program is the responsibility of the 
user. 
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* + 
* + 
+ + 
* + 
* A+ 
* * 
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xx 
* + 


*+ + 
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** 


** 


+ + 


** 


A od 


* + 


** 


* + 


A * 


* A 


** 


* * 


*x X 


* * 


+ + 


A + 


Array.c 


Description: 


Page li- 1 


Array.c contains all functions that relate to definition and 


freeing, 


or allocation, and deabiecation EE 
Table of Contents 
Cover Pages. 6; o RE Page 
List of Array.c Funce tom Veclanratilons m Page 
DefineArraylD() a. PE E Page 
DefineArravz2D ©) meee aces. ss oe Ee 
FreeArraylD —— AAN son BATE 
FreeArrdy2D() «sa E LR RE Page 


T= 
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ie = 
bla 
Ex 
bl 
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xt 
* * 
* X 
* * 
** 
* * 
* * 
* * 
** 
* * 
* * 
* * 
** 
* * 
A k 
* * 


* + 
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de 3 de e de de AR U de de de 


Page 27 += 

Array.c =P 

de de 

sc rot Arrayic Function Declarations x> 
` *w* 

Bescription: SE 
de de 

This is a list of function declarations within the file scope E 
EN "Array.c". x x 


* de 






EEUU OOo oko fe fe se de ee de de e de e e e de e de ede de de e de ede de de dede de dee de ee de de de he e eie de Ye de de de e ede ede e de de de K d e ede e / 


| *DefineArraylD(); Page Ib- 
. **DefineArray2D(); /* Page 11- 4 */ 
IE FreeArrayiD(); (Rage ti Men; 


d FreeArray2D(); /* Page li- 6 */ 


f ko k k k k Ye He d de TT ee 


Ade 
** 
* * 
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de de 
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DefineArraylD 
Description: 


DefineArrayiD allocates memory large enough for a 1 dimensional 
array of length Xmax, where each element has "size" bytes. 


* * 


A ok 


** 


* * 


* * 


de de 


A de 


** 


* k 


e e e ke k he e e ek e de dece ese koc KEK KEK KEE RHE EEN 


YA 


t *DefineArraylD(Xmax, size) 


unsigned Xmax; 
unsigned size; 


int FArrav; 
Array= (int*) calloc(Kmaz, size); 


return (Array); 








Lie 3e 3 je e de oe kx x *x e È dd de de de de de de de de de de de de de de do dle do de de de de de de de de de de de dot ded dd de de de de de de dedi de dd de de de de de de de de de de de de de de dei 


Description: 





**DefineArray2D (Xmax, Ymax, size) 
unsigned Xmax; 


unsigned Ymax; 
unsigned size; 


int gH Array; 
unsigned x; 


(Array=(int**) calloc(Xmax, size); 


return (Array); 


Page 11- 4 
Array.c 


DefineArray2D 


DefineArray2D allocates memory large enough for a 2 dimensional 
array Xmax, by Ymax, where each element has "size" bytes. 


Ifor (x=0; x<Xmax;, x++) Array [x]=(int*) calloc(Ymax, size); 


* * 


* * 


* de 


* x 


* * 


kk 


* * 


** 


kk 


* ok 
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XY X FreeArraylD ** 
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** Descripelen: * + 
* dr * 3 
** FreeArraylD deallocates the memory assigned to the 1 dimensional WI 
HEEN wA 
+ + ** 


e e ie de de d k ok k k O WA ran n Ra 


void FreeArraylD (Array, Xmax) 


int *Array; 


free (Array); 









| 
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EreeArray2D 
Description: 


FreeArray2D deallocates the memory assigned to the 2 dimensional 
array. 


id FreeArray2D (Array, Xmax, Ymax) 
Ent m Array; 

unsigned Xmax; 

unsigned Ymax; 

{ 

Ensigned x; 


for (x=0; x<Xmax; x++) free(Array[x]); 


free (Array); 
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Part Of SACS 1.0 
(StillAnother Cache Simulator) 


Program Modified: 3/17/94 
File Modified: 3/17/94 


Author: William G. Smith 

Address: Electrical Engineering Department 
Naval Postgraduate School 
Monterey, CA 93940 


Copyright 1994, WillsamSs Sms 


Permission to use, Copy, modify, and distribute this software and 

its documentation for any purpose and without fee is hereby granted 
provided that the above copyright notice appears in all copies. No 
modified version of this program should be redistributed without the 
authors consent. William G. Smith makes no warranty or 
representation, promise of guarantee, either expressed or implied, 
with respect to this software's ability to produce valid results. 
This program is provided "as is" any financial, personal or proper 
damage caused by the use of this program is the responsibility of the 
user. 
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TestSACS.c 
Description: 


TestSACS randomly creates instructions and writes them to 
WH Wat". The instrcutions are generated by first choosing 
NoTestCases. The Number of test cases to be used will always 
be less than MaxNoTestCases. Then the TestCaseChoosen is picked 
from TestCases.  TestCases represent different possible ways in 
which an address trace could procede.  PredictedNoRead, HitsInTest, 
and PredictedNoWriteHitsInTest, tells TestSACS how many hits it can 
expect because, it used a specific test. 


Example: 


main () 
{ 


unsigned long int NoLoadHits; 
unsigned long int NoLoadRequests; 


TestSACS (NumberOfRequests, NumberOfHits); 
pumntrt('AniXnNumber of read hits-$ul",NoReadHits); 
printf("\n\nNumber of read requests=%ul", NoReadRequests) ; 


printf("\n\nNumber of write hits=%ul",NoWriteHits) ; 
printf ("XninNumber of write requests-£ul",NoWriteRequests); 


) 
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* + 
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* ok 
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* ok 


* * 
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* de 
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include<time.h> 


include "Global.h" 
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oo Page 12- 2 ** 
tx Test SACS.C * + 
de de de 
**> Description: + + 
de de * dr 
Eb List of definitions. * + 
de de de * 
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#define MaxNoOfTestCases 3 /* Can be changed without other changes. */ 
define NoTestCaseChoices 64 /* // Need to change TestCases, and */ 
tdefine NoLoadStoresInTestCases 7 /* VN PredictedNoHitsInTest */ 


define lrand() ((unsigned long) ((rand()*0x1000l+rand())*0x1000l+rand())) 
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k page” 12= € 
k TestSACS.c XK 
k * + 
k List of TestSACS.c Function Declarations XE 
k * ok 
EE Description: * + 
* k* 
t This is a list of functions declarations within the file scope t 
me Of "TestSACS.c". el 
* de ve 
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oid ChangeArguments () ; (Page o 
oid TestSACS(); /* Page 12= 8 */ 
oid CreatelnstructionSets(); /* Page 12- 9 */ 
oid ShufflingInstructionSets(); /* Page 12-12 */ 
esNoType CanBeSwitched(); /* Page 12-14 */ 


oid WriteInstructionSet(); /* Page 12-15 */ 
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TestSACS.c 


** 


++ 


+ od 


dd 


TestCases 


A de 


* + 


* * 


* + 


Description: 


A de 


* %* 


A de 





A + 
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Loading Test Cases, the each number is an indexe for an array of 


BlockAddressChoices. 
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dc He e e e e e e e de ede de e eode de e e e iie de e e eee KK KK ko A A A A RA EL LL LLLI 
int TestCases[NoTestCaseChoices][NoLoadStoresInTestCases]- 


* ok 
* * 
de + 
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dd 


PredictedNoReadHits, and PredictedNoWriteHits * X 


** 


Description: ZS 
* k 


No Hits Predicted for each test case. * x 


Ak A 
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int PredictedNoReadHitsInTest [NoTestCaseChoices]= 


{ 
6, 5, 5, 4, 
97 4, 4, By 
| 5; 4, 4, 3; 
| 235, 2, 
5, 4, 4, 3, 
D 3, 2, 
Dee, 2, 
EE 2, 1, 
bd 4, 3, 
es, 3, 2, 
ES, 3, 2, 
E 2, 1, 
INE 3S, 2, 
ee, 2, 1, 
ES 2, 1, 
ENT i, 0 
}; 


int PredictedNoWriteHitsInTest(NoTestCaseChoices]- 


= 
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` ` 
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` 
` ` 


` 


` `` ` - - - - - - - ` 
` 
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` 
` 
` 
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** 


* X 


x* 


wx 


x* 
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x* 


Description: 


ChangeArguments, 
user can change. 


ChangeArguments 


change the global variables in SACS that the 


TestSACS.c 


Rage a2- 6 E 
wr 
* k 
** 
* k 
X X 
* k 
X X 
** 


x* 
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void ChangeArgument s () 


{ 


SizeType WordSizeLimit 9, 
SizeType WordsPerSubBlock = 4; 
SizeType NumberOfSubBlocksLimit = 4; 
SizeType NumberOfBlocksLimit = 32; 
AssociativityType AssociativityLimit = 8 
BufferSizeType BufferSizeLimit = 8 
TimeType TimeLimit = 8; 
WordSize = (rand()% (WordSizeLimit-1))+1; 
SubBlockSize = WordSize*((rand()%WordsPerSubBlock)tl); 
BlockSize = SubBlockSize 

* ( (rand ()%NumberOfSubBlocksLimit)+1); 
Associativity (rand () cASSeCliativityLimit) +2; 
CacheSize = BlockSize*Associativity* 


ReadCacheAccessTime 
ReadCacheHitTime 
ReadCacheMissTime 
WriteCacheAccessTime 
WriteCacheHitTime 
WriteCacheMissTime 
MemoryAccessTime 
MemoryTransferTime 
BufferCacheAccessTime 


ReadBufferSize 
WriteBufferSize 


BlockReplacementPolicy 
WritePolicy 
WriteMissPolicy 
ReadForward 
CPUWaitsForCacheWrites 
SearchBlockBuffer 
UpdateReadBuffer 
RemoveReadDuplicates 
RemoveWriteDuplicates 


ReadPriority 
WritePriority 


( (zand () £NumberOfBlocksLimit)-41); 


rand ()%TimeLimit; 
rand()£TimeLimit; 
rand()%TimeLimit; 
rand()£TimeLimit; 
rand () $TimeLimit; 
rand()$TimeLimit; 
rand()3TimeLimit; 
rand()?TimeLimit; 
rand()$TimeLimit; 


(rand () 4BufferSizeLimit)+1; 
(rand() tBufferSizeLimit) +1; 


= rand() tNumberOfReplacementPoliciesAvailable; | 


ReadForWriteAllocatePriority = 


WriteDirtyBlockPriority 


rand () tNumberOfWritePoliciesAvailable; 

rand () tNumberOfWriteMissPoliciesAvailable; 

rand() Unknown; 

rand () Unknown; 

rand () Unknown; i 
rand () Unknown; 

rand () Unknown; 

rand()%Unknown; 


(rand ()$ (NoPETIOLSUDU DITE 
(rand()3(NoPriorit 1)) HI; 
(rand ()% (NoPriority-1))+1; 
(rand()%(NoPriority-1))+1; 


NEE EE A AA AE KEE EA EE EE AA E EA de d de A 


^ Page 127 min 
Ï TestSACS.c mt 
N ** 
+ ChangeArguments EX 
F continued E 
k A + 
EE Description: iE 
e de dr 
F Ensuring that the new arguments are valid combinations. $ 


k * * 


DEDICO e oe oe e oe oe oe oe d e oe H H H e e de e e e de e e de de e e e e e e e e e e e e e e e ede de e d e de de e de de de d e e e de e d $ H K H d H de H K e e de | 
| 

^ if (SearchBlockBuffer==No) RemoveReadDuplicates=No; 
| 


NES (UpdateReadBuffer ==Yes) WordSize=SubBlockSize; 


1 ře ře k de de de O O o O. 
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* * Test SACS.C X X 
** ** 
x TestSACS WA 
* * Sé 
**. Descolotron: ** 
** ** 
= TestSACS will create a test set, shuffle the instructions, and SCH 
** write them out to "SACS.Dat * * 
** + + 


Dede ÃO ÃO AN A A A AAA AD 


void TestSACS (NumberOfRequests, NumberOfHits) 


ScoreType *NumberOfRequests; 
ScoreType *NumberOfHits; 


{ 


char Request [MaxNoOfTestCases*NoTestCaseChoices+l]; 
AddressType DataAddress [MaxNoOfTestCases*NoTestCaseChoices-*1]; 
SizeType Size [MaxNoOfTestCases*NoTestCaseChoices+l); 
TimeType TimeUntilNextReguest [MaxNoOfTestCases*NoTestCaseChoices+l]; 
int Imax-0; 


DisplayTestingHeader (); 


CreateInstructionSets (Request, DataAddress, Size, TimeUntilNextRequest, 
&Imax, 
NumberOfRequests, NumberOfHits); 


ShufflinginstructionSets (Request, DataAddress, Size, TimeUntilNextRequest, 
Imax); 
rewind(DataFile); 


WriteInstructionSet (Request, DataAddress, Size, TimeUntilNextRequest, 
Imax); 

rewind (DataFile); 

EndOfDataFile=No; 


} 
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TesesAcs.c YA 

** 

Createlnstmetilonsets Weg 

** 

Description: xx 
* * 

Me truetlons are created from a Set of test cases. The rx 

NI NEUDer Cof predicted hits for each case is stored in SCH 
PREEMebecNoHitsInTest. CreateInstructionsSets randomly chooses the Nt 
Beet@@eem@edses to be used, and randomly selects the individual "x 
TestCases. The BlockAddressChoices for each test case is also chosen ER 
Bem@emly. The DataAddress, and Size of each instuction is chosen SH 
ssmdomi such that they are within the block chosen. The NoLoadHits sa 
gere dscted by summing up all of the PredictedNoHitsInTest. E 


** 
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did CreateInstructionSets (Request, 


DataAddress, 
Ec 
PExmeuUnctisNexcthHRequest, 
Imax, 
NumberOfRequests, 
NumberOfHits) 

char Request; 

AddressType *DataAddress; 

Size 1 ype EE 

TimeType *TimeUntilNextRequest; 

Int * Imax; 


ScoreType *NumberOfRequests; 
ScoreType *NumberOfHits; 


{ 


TimeType MaxTimeUntilNextRequest = 101; 
AddressType BlockAddressChoices[NumberOfRequestsAvailable]; 
SizeType SetChosen; 


int TestCaseIndex; 
int LoadIndex; 

int NoOfTestCases; 
int TestCaseChosen; 
Ent i, j,K; 


time t t; 
* srand((unsigned) time(&t)); */ /* Uncomment to randomize each test run */ 
/* otherwise every test run will be 2 
/* identical. Leaving the seed i 
/* commented out allows any errors E 
/* found by -test to be revisited. WÉI 


NumberOfRequests [Read ]=0; 
NumberOfRequests [Write]=0; 
NumberOfHits [Read ]=0; 
NumberOfHits [Write]=0; 


ře ee O o k "de d H hee hehe e E O O. 


* + Rage ei LU. "E 
s TestSACS.c * * 
** Jr + 
>+ CreatedInstrutionSets * * 
=> Continued + + 
*ock * Y 
** "DESCAIDELONE * * 
* À + A+ 
GE Creating one EIERE * * 
** de + 


e Se e ce e e d Hd d de Hd he e d de e e ee O O.. 


*Imax=0; 
NoOfTestCases=rand () $MaxNoOfTestCasestl; 
for (TestCaseIndex=0; TestCaseIndex<NoOfTestCases; TestCaseIndex++) 


{ 


TestCaseChosen=rand ()%NoTestCaseChoices; 
SetChosen=rand () %NumberOfSets; 


BlockAddressChoices [Read] = 
( ( (lrand()/(NoOfTestCases*NumberOfSets*BlockSize)) 
*NoOfTestCases+TestCaseIndex) 
*NumberOfSets + SetChosen) * BlockSize; 


BlockAddressChoices [Write]=BlockAddressChoices [Read]; 
If (rand():2) 
BlockAddressChoices [Write]= 
( ( (lrand()/(NoOfTestCases*NumberOfSets*BlockSize)) 
*NoOfTestCases+TestCaselIndex) 
*NumberOfSets + SetChosen) * BlockSize; 


if (BlockAddress (BlockAddressChoices [Read] ) !=BlockAddressCnhoices [Read] ) 1) 
printf ("Read ís not a BlockAddress"); 

if (BlockAddress (BlockAddressChoices [Write] ) !=BlockAddressChoices [Write] ) 
printf("Write is not a BlockAddress"); 


if (Set (BlockAddressChoices [Read] ) !=SetChosen) 
printf ("Read is not a good Set"); 


if (Set (BlockAddressChoices (Write]) !=SetChosen) 
printf ("Write is not a good Set"); 


if (BlockAddressChoices {Read]==BlockAddressChoices [Write] ) 
printf ("%t4dE", TestCaseChosen) ; 

else 
printf ("%4daN",TestCaseChosen); 

if (TestCaseIndex%15==14) printf("\n"); 
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if (BlockAddressChoices [Read] ==BlockAddressChoices [Write] ) 
{ 
NumberOfHits [Read] +=PredictedNoReadHitsInTest [TestCaseChosen] ; 
NumberOfHits [Write]+=PredictedNoWriteHitsInTest [TestCaseChosen]; 





| LoadIndex=0; 
| while (TestCases[TestCaseChosen][LoadIndex]--Write && 
WriteMissPolicy!-WriteAllocate && 
LoadIndex«NoLoadStoresInTestCases) 
{ 
NumberOfHits[Write]--; 
LoadIndex++; 
} 
if (TestCases[TestCaseChosen][0]==Read && TestCaseChosen!=0) 
NumberOfHits[Write])]++; 
if (TestCases[TestCaseChosen] [0]==Write 464 
WriteMissPolicy==WriteAllocate) 
NumberOfHits [Read]++; 
} 
else 
{ 
NumberOfHits [Read] +=PredictedNoReadHitsInTest [TestCaseChosen] ; 
if (WriteMissPolicy==WriteAllocate) 
NumberOfHits [Write] +=PredictedNoWriteHitsInTest [TestCaseChosen] ; 


} 


for (LoadIndex=0; LoadIndex<NoLoadStoresInTestCases; LoadIndex++) 
{ 
if (TestCases[TestCaseChosen] [LoadIndex]==Read) 
{ 
Request [*Imax]="r'/; 
NumberOfRequests [Read] ++; 
} 
else 
{ 
Request [*Imax]='w’ ; 
NumberOfRequests [Write] ++; 
} 


DataAddress[*Imax] = 
BlockAddressChoices[TestCases[TestCaseChosen] [LoadIndex]]; 


Size[*Imax]-lrand()$BlockSize-*1; 
if (Size[*Imax]«BlockSize) 

DataAddress[*Imax] += lrand()% (BlockSize-Sizel*Imax])+1; 
TimeUntilNextRequest[*Imax]-lrand()$MaxTimeUntilNextRequest; 


max) ++; 
} 


ee ok k ee e dee dede de de de de k de de De de AS SR 


** 
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* de 


+ + 


* * 


de de 
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ShufflingInstructionSets 


Description: 


Shuffling Instruction Sets. 
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** 


** 


** 


* * 


** 


** 


* + 


** 


+ + 


ALLA 


void ShufflingInstructionSets (Request, 


char 
AddressType 
SizeType 
TimeType 
INC 


{ 


¿ne 

char 
AddressType 
SizeType 
TimeType 
INI Rae 


DataAddress, 
Size, 
TimeUntilNextRequest, 
Imax) 
EE 
*DataAddress; 
*Size; 
*TimeUntilNextRequest; 
Imax; 
Jump; 
RequestTemp; 
AddressTemp; 
SizeTemp; 
TimeTemp; 





page 12-13 
TestSACS.c 


ShufflingInstructionSets 
continued 


* * 


* * 
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| 
| 


Bor (i=1; 


{ 


i<Imax; i++) 


Jump=Yes; 


{ 


if 


Pet 


PF 


af 


for (jJ=i; J>0 66 Jump==Yes; j--) 


(BlockAddress (DataAddress (j])==BlockAddress (DataAddress (j-1])) 
Jump=No; 


((rand()$(Associativity*NoLoadStoresInTestCases))--0) 
Jump-No;  /* Gives Uniform distrabution. */ 


(Jump==Yes) 
Jump=CanBeSwitched (DataAddress, 5, Imax); 


(Jump==Yes) 

{ 
RequestTemp-Request[j-1]; 
Request [j-1]=Request [j]; 
Request (})=RequestTemp; 


AddressTemp=DataAddress (j-1]; 
DataAddress ([j-1]=DataAddress [5]; 
DataAddress (j]|=AddressTemp; 


SizeTemp=Size[j-1]; 
Size[j-1]=Size[3); 
Size[3j]=SizeTemp; 


TimeTemp=TimeUntilNextReguest (j-1]; 
TimeUntilNextRequest [j-1]=TimeUntilNextRequest [j]; 
TimeUntilNextRequest [j]=TimeTemp; 

} 


f Re ede dede RI e de d k k o o o... 


de * 


de + 


* 


* x 


* * 


* * 


* + 


* * 
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CanBeSwitched * + 

k* 

DESCRIPTION: ** 
de + 

Can InstructionAddress[i] be switched with Instruction[i-1]. * * 

If so return Yes, else return No. * * 


* * 


Kk kk o TE / 


YesNoType CanBeSwitched(DataAddress, Io, Imax) 


unsigned long int *DataAddress; 


int Io; 

THE Imax; 

( 

INE 1, 3; 
YesNoType Jump=Yes; 
YesNoType NoJumped; 
YesNoTyre JumpedBefore; 


unsigned long int AddressJumped[100]; 
Jump-Yes; 


NoJumped-1; 
AddressJumped{0]=BlockAddress (DataAddress[Io]); 
1710-2; 
while (i»-0 && NoJumped«Associativity && 
BlockAddress (DataAddress[i])!=BlockAddress (DataAddress[Io-1])) 
{ 
JumpedBefore=No; 
for (j=0; j<NoJumped; j++) 
if (AddressJumped[3]==BlockAddress (DataAddress[i])) JumpedBefore-Yes; 
if (JumpedBefore==No 464 NoJumped«Associativity) 
AddressJumped [NoJumped++]=BlockAddress (DataAddress [i]); 
l-7; 
) 


if (NoJumped>=Associativity) Jump=No; 


NoJumped=1; 
AddressJumped[0]=BlockAddress (DataAddress[Io-1]); 
i=lo+1; 
while (i<Imax 68 NoJumped<Associativity 46 
BlockAddress (DataAddress[i])!-BlockAddress (DataAddress (Io])) 
{ 
JumpedBefore=No; 
for (j=0; j<NoJumped; j++) 
if (AddressJumped[j]==BlockAddress (DataAddress[i])) JumpedBefore=Yes; 
if (JumpedBefore==No 44 NoJumped<Associativity) 
AddressJumped [NoJumped++]=BlockAddress (DataAddress [i]); 
i++ 
) 


1f (NoJumped>=Associativity) Jump=No; 
return (Jump); 


} 





kA dk kk k+ dk dk k k dk k k k+ k k + + k k x x *x x x x+ x x x x x x+ *+ x x x+ xk x x x+ xk x x x x x x * x x x x x x x x x x x x x x x+ x x X x x x *x X *x *x * * *x * 


k 


1 


k 
* 





* 
* 
* 
* 
* 
* 


pescription: 


TestSACS.c 


WriteInstructionSet 


Write SACS.Dat one line at a time. 


loid WriteInstructionSet (Request, 


DataAddress, 

Size, 
TimeUntilNextRequest, 
Imax) 


char *Request; 

AddressType *DataAddress; 

ExzeType WSIZE; 

TimeType *TimeUntilNextRequest; 


int Imax; 


{ 


Mat 1; 


for (i=0; i<Imax; 


{ 


itt) 


berinti(DataFile, "sc " Sac St; 

meee: (DataFile, "S0O81X ",DataAddress[1i]); 

NTE (MDataFile, "$2u " ,Size[1]); 

ANNE (DataFile, "Slu" „TimeUntilNextReguest [i]); 
i unsf(DataFile," Nin"); 


} 


bprspntr(DataFile, 
REES EE Det a Ei Le, 
fprintf (DataFile, 
fprintf (DataFile, 
£printf(DataFile, 


) 


"End Of Trace\n\n"); 

manu instructions followin"); 
"they were not used for then"); 
"last run. pons 
nun") ; 
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* * 


* * 


* * 


de k 


* * 


* * 


* k 


* * 


* + 
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(Koko kok k kk ok ü X H H E ÃO DI TD RO WA WA 


s Page 13-0 
e ic Inge ** 
* Xx * ck 
** Part QE SACS PU ES 
m (StillAnother Cache Simulator) ** 
kk ** 
** ` Program Modified: ES ** 
E File Modified: 3/17/94 * * 
** kk 
WA Author: William G. Smith * * 
ae Address: Electrical Engineering Department * * 
* Naval Postgraduate School ** 
m Monterey, CA 9399420 = 
* $ ** 
Xm Copyright 1994, William c T omien * * 
Ké: * * 
= Permission to use, copy, modify, and distribute this software and WA 
= its documentation for any purpose and without fee is hereby graated Ss 
Wa provided that the above copyright notice appears in all Copies. No tk 
WA modified version of this program should be redistributed without the Kä 
Gs authors consent. William G. Smith makes no warranty or u 
tx representation, promise tot guarantee, either peo ssd ne YA 
>- with respect to this software's ability to produce valid results. wA 


wa This program is provided "as is" any financial, EES `> 


damage caused by the use of this program is the responsibility of then 


Xm user. X 
*X* 


** 


** 
joo ok kok A A A a T 





k ok o e *+ * kx e ode Oc dee cc ce k+ k k+ k * k k kx k x xk x x k x x kx k x coe cc x c x x *x x *x x kx x *x k x *x c oc de rr 


Pagem T ` ** 





CHEERING. C a 

*o* 

Description: Zr 

* + 

Mir cking.c contains all of the functions that relate to error x 

Bron Note that an error could be raised anywhere. The error M 

mesage will contain the procedure name in square brackets. This Ex 

section contains the functions spicifically designed to check variable Yx 

to see if they are consitant with each other, and if they are within te 

set boundarys. ga 

*o* 

Table of Contents = 

* * 

roo Page 3-1 <= 

SE or cCache.c Function Declarations ..... Pagem 2 ae 

O oorner Page 13- 3 GE 

ET e e EEN Page 13- 4 a 

REENEN .................... Page 13-11 wa 

met kinaForValuesoutOfBoundsí() ......... Page 13-12 E* 

EEEHImebBounddryError(); ........... Page 13-15 e 

' EEREScoreBoundaryError(); .........- Page 13-16 za 

e PTE S zeBOUndaryError(l); ..........o Page 15-17 x 

i PebiibiumBoundaryError(); ........... Page 13-18 E 

d SHeekmgrorInconsistencles() ........... Page 13-19 E. 

- PŘREML TotalTimeError() ............... Page 13-21 >- 

x Pieno ta 'SCOFCErrori() .............. Page 18-22 sa 

s ob odictions() .................... Page 13-23 diu 

: IEUEScorePredictionError() ............ Page 13-24 => 

f eene l imePredictionError() ................ Page 13-25 aes 

k x À 
t 


l ok e ee de de e dece eoe rr e k e e d e X e e de de de dn e dede e x % / 


EBclude "Global.h" 


dede de de O ÃO CCR ee 
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* * 
* * 
A 
A H 
* * 
** 
** 
* * 
* * 


* h 


Checking.c 
List of Checking.c Function Declarations 


Description: 


This is a list of function declarations witnin the file scope 


of "Cheekincecdi. 


kk 


de de 


de Y 


e 3e de kk He de de de de de de de de K de Ke K de de de d K A X 


vole 
vola 
void 
vond 
võid 
void 
void 
void 
Volo 
void 
void 
void 
void 
void 


Checking(); 
CheckingConstants(); 
PrintConstError()5 
CheckingForValuesOutOfBounds (); 
PrintTimeBoundaryError(); 
PrintScoreBoundaryError(); 
PrintSizeBoundaryError(); 
PrintEnumBoundarykrror () ; 
CheckingForInconsisteneres (0 
PrintTotalTimeError(); 
PrintTotaiscoreLrror(); 
CheckingPredictions (); 
PrintScorePredictionError(); 
Print TimePredictiênBrront; 


Page 
Page 
Pace 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
rage 
Page 
Page 
Page 


13-25 
13- 4 
LI ak 
13 12 
13715 
13216 
1951 
138 
13-19 
13-2 
13222 
13-225 
13-24 
13-25 





^ e e e oce ceo oe eoe oe A rr kr rr De * *% HT 
Page 13- 3 ++ 

Checking.c * + 

* de 

Checking * + 

de de 

M Description: * * 
* * 
r Checking checks the global variables to insure that constants Xx 
* remain constant, and Values are in bounds, als that there are no Nx 


+ inconsistencies. ee 


t * + 





E e e O O Ee de de de de de de de de de de de H H d d d d H H K d d d 3 $ 3% $ dœ | 


| 
| 
E. Checking () 


< 


{ 


CheckingConstants (No); 
CheckingForValuesOutOfBounds (); 
CheckingForInconsistencies(); 


[/kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk*x 


E Page 13- 4 ** 
EE Checking.c YA 
Ké * + 
* + CheckingConstants baat 
** * * 
** ` Description: * * 
NUM * + 
NS Checking global constants to insure that they do not change, * * 
** unless they are being Reset. * + 
* + de de 


dede de e e de "de de He de de de de de de de WANA eee 


void CheckingConstants (Reset) 
YesNoType Reset; 


{ 





static CacheSizeType CacheSizeCopy; 

static SizeType BlockSizeCopy; 

static SizeType SubBlockSizecopy; 

static Assocriativiti pe ASSOClativitvCODY; 

static SizeType WordSizeCopy; 
EE ReadCacheAccessTimeCopy; 
static TimeType ReadCacheHitTimeCopy; 
static TimeType ReadCacheMissTimeCopy; 
static TimeType WriteCacheAccessTimeCopy; 
static TimeType WriteCacheHitTimeCopy; 
static TimeType WriteCacheMissTimeCopy; 
static TimeType MemoryAccessTimeCopy; 
static TimeType MemoryTransferTimeCopy; 
static TimeType BufferCacheAccessTimeCopy; 
static BufferSizeType ReadBufferSizeCopy; 

static BufferSizeType WriteBufferSizeCopy; 

static BlockReplacementPolicyType BlockReplacementPolicyCopy; 
static WritePolicyType WriteFolicyCopy; 

static WriteMissPolicyType WriteMissPolicyCopy; 

Static YesNoType ReadForwardCopy; 

Static YesNoType CPUWaitsForCacheWritesCopy; 
static YesNoType SearchBlockBufferCopy; 
Static YesNoType UpdateReadBufferCopy; 
Static YesNoType RemoveReadDuplicatesCopy; 
Static YesNoType RemoveWriteDuplicatesCopy; 
Static PriorityType ReadPriorityCopy; 

static Priority Type WritePriorityCopy; 

static PriorityType ReadForWriteAllocatePriorityCopy; 
Static PriorityType WriteDirtyBlockPriorityCopy; 
static Priority. pe NoPriorityCopy; 

static YesNoType CheckCopy; 

static YesNoType KeyBoardIOCopy; 

static char *DataFileNameCopy; 

static HistogramIndexType ScreenHistogramMaxIndexCopy; 
Static HistogramIndexType FileHistogramMaxIndexCopy; 


É 






| static SizeType 
Static SizeType 


static SizeType 
static AddressType 
Static TimeType 

| 


static SizeType 


msatic YesNoType 
static YesNoType 


static TimeType 
static TimeType 


static TimeType 
static TimeType 


static ScoreType 
Static ScoreType 
rat- ScoreType 
static ScoreType 
static ScoreType 


static FILE 


Checkdne.c 


CheckingConstants 
continued 


NumberOfBlocksCopy; 
NumberOfSubBlocksCopy; 
NumberOfSetsCopy; 


*CacheBlockAddressCopy; 
*LastCacheBlockAccessTimeCopy; 


*CacheNextBlockCopy; 


**CacheValidBitCopy; 
**CacheDirtyBitCopy; 


**RequestTimeHistogramCopy; 
**StallTimeHistogramCopy; 


*TotalReguestTimeCopy; 
*TotalrscalrTIinmnecoepy ; 


*NumberOfAccessesCopy; 
*NumberOfCacheHitsCopy; 
*NumberOfBufferHitsCopy; 
*PredictedNumberOfACcessesCopy; 
*PredictedNumberOfHitsCopy; 


*DataFileCopy; 


[de de de di ce de * * * * * * * * * * * *% *% Á k kk kk k kk k de de e ce oe oe e e oe de e oe ce oe * * K K KZ K AA kk kk + ++ k kk +k k +k k Ak + +K + + A+ + 
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* de 


* * 


* * 


de de 


de de 


de de 


a O oe sese a kx k A A kx x x x x Xx hee de eee e dede AAA ARA RARA AAA AAA RARA e he e e % de % H % H % / 


ff o fe he de e e de de O S O RR nen 


+ + 


+ À 


A de 


+ + 


A de 


** 
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Checking.e 


CheckingConstants 
continued 


** 


*ock* 


* $x 


** 


* + 


** 


de e He de d de ke de de de K Ke e kde de de de de d de de de de de Ke Ke d ke de c de de de d d d de de de de de de Ke de de Ke de de de e de de de de ke de de de d d K de d e ke kk ke ke / 


if 


(Reset) 


{ 


CacheSizeCopy 
BlockSizeCopy 
SubBlockSizeCopy 
AssociativityCopy 
WordSizeCopy 


ReadCacheAccessTimeCopy 
ReadCacheHitTimeCopy 
ReadCacheMissTimeCopy 
WriteCacheAccessTimeCopy 
WriteCacheHitTimeCopy 
WriteCacheMissTimeCopy 


MemoryAccessTimeCopy 
MemoryTransferTimeCopy 
BufferCacheAccessTimeCopy 


ReadBufferSizeCopy 
WriteBufferSizeCopy 


BlockReplacementPolicyCopy 
WritePolicyCopy 
WriteMissPolicyCopy 
ReadForwardCopy 
CPUWaitsForCacheWritesCopy 
SearchBlockBufferCopy 
UpdateReadBufferCopy 
RemoveReadDuplicatesCopy 
RemoveWriteDuplicatesCopy 


ReadPriorityCopy 
WritePriorityCopy 


CacheSize; 
BlockSize; 
SubBlockSize; 
AS Ss O CHECA; 
WordSize; 


ReadCacheAccessTime; 
ReadCacheHitTime; 
ReadCacheMissTime; 
WriteCacheAccessTime; 
WriteCacheHit Time; 
WriteCacheMissTime; 


MemoryAccessTime; 
MemoryTransferTime; 
BufferCacheAccessTime; 


ReadBufferSize; 
WriteBufferSize; 


= BlockReplacementPolicy; 


ReadForWriteAllocatePriorityCopyf= 
WriteDirtyBlockPriorityCcopy = 


NoPriorityCopy 
CheckCopy 


KeyBoardlOCopy 
DataFileNameCopy 


ScreenHistogramMaxIndexCopy 


FileHistogramMaxIndexCopy 


WritePolicy; 
WriteMissPolicy; 
ReadForward; 
CPUWaitsForCacheWrites; 
SearchBlockBuffer; 
UpdateReadBuffer; 
RemoveReadDuplicates; 
RemoveWriteDuplicates; 


ReadPriority,; 

WritePriority; 
ReadForWriteAllocatePriority; 
WriteDirtyBlockPriority; 


= NoPriority; 


Check; 


KeyBoardIO; 
DataFileName; 


= ScreenHistogramMaxIndex; 


FileHistogramMaxIndex; 








***** KA AA 
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Checking.c ER 

| * * 
| CheckingConstants E 
continued * * 


de de 
e se fe k k k k k kx k kx kx k X k k X e e ic k e de ee %) % % k % k k X de e e k % k e % k à Kk de e dee H % e K k % k e e hee k K K H hee e hee de e e % e e / 


| 
| 


| NumberOfBlocksCopy = NumberOfBlocks; 

| NumberOfSubBlocksCopy = NumberOfSubBlocks; 
NumberOfSetsCopy = NumberOfSets; 
CacheBlockAddressCopy = CacheBlockAddress; 
LastCacheBlockAccessTimeCopy = LastCacheBlockAccessTime; 
CacheNextBlockCopy = CacheNextBlock; 
CacheValidBitCopy = CacheValidBit; 
CacheDirtyBitCopy = CacheDirtyBit; 
Request TimeHistogramCopy = RequestTimeHistogram; 
StallTimeHistogramCopy = StallTimeHistogram; 
TotalReguestTimeCopy = TotalReguestTime; 
TotalStallTimeCopy = TotalStallTime; 
NumberOfAccessesCopy = NumberOfAccesses; 
NumberOfCacheHitsCopy = NumberOfCacheHits; 
NumberOfBufferHitsCopy = NumberOfBufferHits; 
PredictedNumberOfAccessesCopy = PredictedNumberOfAccesses; 
PredictedNumberOfHitsCopy = PredictedNumberOfHits; 


DataFileCopy = DataFile; 


) 


f e e ke e eee ecce e de de de de de de de de S. t 


X X Rage 13- 8 "== 
** Checking.c ** t 
* de *x i 
* x CheckingConstants => 
X X continued SE | 
** kx 


RRA AR RR A RR RAN AR AA AA RARA AAA AA AAA RARA AAA RA AAA AAA RARA AAA AAA RARAS 


if (!(Reset)) 


{ 





if( CacheSizeCopy |= CacheSize) 
PrintConstError (“Cache mweza 

if( BlocksszeCopy |= BlockSize) 
PrintConstError ("BlockSize we 

ïf ( /SubBlockS5SizeCony Le SubBlockSize) 
Print ConstErLoL ("SubDbBlockS 1220 

if( AssociativityCopy !- Associativity) 
PrintConstError("Associativity "MM 

if( WordSizeCopy |= WordSize) 
PrintConstError("WordSize"); 

if( ReadCacheAccessTimeCopy |= ReadCacheAccessTime) 
PrintConstError ( ReadCagheAccesciime: Ji; 

if ( ReadCacheHitTimeCopy |= ReadCacheHit Time) 
PrintConstError ("ReadđdCacheHit Time; 

if( ReadCacheMissTimeCopy !- ReadCacheMissTime) 
PrintConstError ("ReadCacheMissTime"); 

if( WriteCacheAccessTimeCopy !- WriteCacheAccessTime) 
PrintConstError ("WriteCacheAccessTime"); 

if( WriteCacheHitTimeCopy |= WriteCacheHitTime) 
PrintConstError ("WriteCacheHitTime"); 

if( WriteCacheMissTimeCopy |= WriteCacheMissTime) 
PrintConstError("WriteCacheMissTime"); 

if( MemoryAccessTimeCopy !- MemoryAccessTime) 
PrintConsenrror ( 'MemoryAccess Toe 

if( MemoryTransferTimeCopy |= MemoryTransferTime) 
PrintConstError ("MemoryTransferTime"); 

if( BufferCacheAccessTimeCopy l= BufferGacheAccessTime) 
PrintConstError ("BufferCacheAccessTime"); 

if( ReadBufferSizeCopy |= ReadBufferSize) 
PrintConstError ("ReadBufferSize"); 

if( WriteBufferSizeCopy |= WriteBufferSize) 
PrintConstError ("WriteBufferSizel); 

if( BlockReplacementPolicyCopy !- BlockReplacementPolicy) 
PrintConstError("BlockReplacementPolrcy ); 

if( WritePolicyCopy |= WritePolicy) 
PrintConstError("WritePolycevo 

if( WriteMissPolicyCopy !- WriteMissPolicy) 
PrintConstError("WriteMisSSPOlyG >); 

if( Read? oiward copy !- ReadForward) 
PrintConstError ("ReadForward"); 

1f( CPUWaitsEeGrcacheWwritesetepy |= CPUWaitsForCacheWrites) 
PrintConstError("CPUWaitsForCacheWrites"); 

if( SearchBlockBufferCopy |= SearchBlockBuffer) 
PrintconstError(SearchBElockBUt ten 

if( UpdateReadBufferCopy |= UpdateReadBuffer) 


PrintConstError ("UpdateReadBuffer"); 


È” 


nf 
if( 
BEE ( 
ES 
at ( 
Jí 
at ¢ 
if 
Li 
if( 
a E ( 


If 
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CheckingConstants 
continued 


RemoveReadDuplicatesCopy |= RemoveReadDuplicates) 
PrintConstError ("RemoveReadDuplicates"); 
RemoveWriteDuplicatesCopy "e RemoveWriteDuplicates) 
PrintConstError("RemoveWriteDuplicates"); 

ReadPriorityCopy |= ReadPriority) 
PrintConstError("ReadPriority"); 

WritePriorityCopy |= WritePriority) 
EuntconstError("WritePriority"); 
ReadForWriteAllocatePriorityCopy != ReadForWriteAllocatePriority) 
PrintConstError("ReadForWriteAllocatePriority"); 
lwwiéebirtyBlockPriorityCopy f= WriteDirtyBlockPriority) 
Wédééé.ConstError("WriteDirtyBlockPriority"); 

NOPriorityCopy |= NoPriority) 
ExnitconstError("NoPriority"); 

CheckCopy !- Check) 

ExunsConstError ("Check"); 

KeyBoardIOCopy |= KeyBoardIO) 
EmuntConstError ("KeyBoardIO"); 

DataFileNameCopy !— DataFileName) 
PrintConstError("DataFileName"); 
ScreenHistogramMaxIndexCopy |= ScreenHistogramMax Index) 
PrintConstError ("ScreenHistogramMaxIndex"); 
FileHistogramMaxIndexCopy |= FileHistogramMaxIndex) 


PrintConstError ("FileHistogramMaxIndex"); 


"kx x x+ k x x x+ x x x x x+ x+ x x x xk x x x x x x x x x x x x kx *x x x x x x x x kx x x x x x x x kx x x x x x x x x *x *x* x x x Xx x x x * x *x x *x * * * * * * K 


** 


* * 


** 


* * 


* * 


* x 


E AAA ARA AAA AA AEREA ARRE REA ARA He de de e eee de / 


f RR e eee ke ek ke e e e e khe de ke e e he e de e de hk e kk ek kk ke ek e ke ek e e kk e hk ek ee ke e E a e 


* x 


* * 


kk 


A de 


** 


* + 
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Checking c 


CheckingConstants 
continued 


** 


* + 


de de 


* * 


** 


** 


h de e de K RR ROO de de RAOL de de e de de de de de de de K de K de De de de e RARA RR DR E / 


LÉA 
A E 
L'EX 
ï EX 
ELM 
ifi 
LE 
TEX 
EEX 
ifi 
VEN 
LAI 
LEI 
1 E 
VE 
LÉ 
if 


LEN 


Nur  rOfBlocksCopy 
Pri  ConstError("NumberOfBlocks") 
NumLerOfSubBlocksCopy 


|= NumberOfBlocks) 


+ 
, 


L= NumberOfSubBlocks) 


PrintConstError ("NumberOfSubBlocks"); 


NumberOfSetsCopy 
PrintConstError ("NumberOfSets"); 
CacheBlockAddressCopy 


'= NumberOfSets) 


|= CacheBlockAddress) 


PrintConstError("CacheBlockAddress"); 


LastCacheBlockAccessTimeCopy 


|= LastCacheBlockAccessTime) 


PrintConstError("LastCacheBlockAccessTime"); 


CacheNextBlockCopy 
PrintConstError ("CacheNextBlock"); 
CacheValidBitCopy 
PrintConstError( CacheValidBit' 5j 
CacheDirtyBitCopy 


PrintConstError("CaeheDuirtyBItUss 
RequestTimeHistogramCopy 


|= CacheNextBlock) 


r 


|= CacheValidBit) 
|= CacheDirtyBit) 


|= RequestTimeHistogram) 


PrintConstError ("Request TimeHistogram"); 


StallTimeHistogramCopy 


|= StallTimeHistogram) 


PrintConstError("StallTimeHistogram"); 


TotalRequestTimeCopy |= TotalRequestTime) 
PrintConstError("TotalReguestTime"); 
TotalStallTimeCopy |= TotalStallTime) 
PrintConstError("TotalStalWdMPime i 
NumberOfAccessesCopy '= NumberOfAccesses) 
PrintConstError ("NumberOfAccesses"); 
NumberOfCacheHitsCopy |= NumberOfCacheHits) 


PrintConstError ("NumberOfCacheHits"); 


NumberOfBufferHitsCopy 


!- NumberOfBufferHits) 


PrintConstError ("NumberOfBufferHitsCopy"); 


PredictedNumberOfACcessesCopy 


!— PredictedNumberOfAccesses) 


PrintConstError ("PredictedNumberOfAccesses"); 


PredictedNumberOfHitsCopy 


|= PredictedNumberOfHits) 


PrintConstError ("PredictedNumberOfHits"); 


DataFileCopy 
PrintConstError("Datafile"); 


!- DataFile) 





*kk*k*k kk *k*k*k*k*k*k***k** x kx kx k xk kx x k k kx x k x kx k k x x k kx x kx k x k x x k k x k k k k k x * k x k x x x k k x A RAR RR RA e e 
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Checking. 8 * * 

* 3 

, PrintConstError * * 
* * 


f 
MEE AE EE ARRE RAE REA AAA AAA RARA AAA RARA RARAS 


| 
bid PrintConstError (VariableName) 


char *VariableName; 


Nut nmunError in (CheckingConstants]"); 
printf(" \n%s did not remain constant.\n", VariableName) ; 
Ex ït (0); 


de de e de ede eee ee ee de e de Se de e Ye de T O 


** 


** 


** 


** 


** 


** 


* * 


* ok 


* ok 


* + 


age iz tk 


Checking qe * + 

de de 

CheckingForValuesOutOfBounds s 

* ok 

Description: * x 


* * 


CheckingForValuesOutOfBounds checks all bounded global variables te 


to see if they fall within their prescribed boundaries. * * 


** 


c de e ce ce ce ee e che de de e de e ee eoe e de de de He de de de He de de de de de de de d de de ede dece dee hee eee ee ee ee ee ee e ee de he e e ede ee e de e ee / 


void CheckingForValuesOutOfBounds () 


{ 


TimeType MaxTime =10000000001; 
ScoreType MaxScore=10000000001; 


SizeType BlockIndex; 
SizeType SubBlockIndex; 
SizeType SetIndex; 
RequestType RequestIndex; 


CacheWaitingForType StallIndex; 


if 


ER 


abe 


T 


YE 


LE 


YE 


it 


(Time<0 
|| Time>MaxTime) 
Print TimeBoundaryError ("Time”, Time, 01, MaxTime) ; 


( CacheWaitingFor<Nothing 
|| CacheWaitingFor»NumberOfCacheWaitingForsAvailable) 
PrintEnumBoundaryError ("CacheWaitingFor",CacheWaitingFor, 

Nothing, NumberOfCacheWaitingForsAvailable); 


( MemoryWaitingFor<NothingTwo 
|| MemoryWaitingFor»NumberOfMemoryWaitingForsAvailable) 
PrintEnumBoundaryError ("MemoryWaitingFor",MemoryWaitingFor, 

NothingTwo, NumberOfMemoryWaitingForsAvailable); 


( BlockWaitingFor<NothingThree 
|| BlockWaitingFor>NumberOfBlockWaitingForsAvailable) 
PrintEnumBounddafyError ("BloekWaitingror ,BLlockWaltimeron, 

NothingThree, NumberOfBlockWaitingForsAvailable ); 


( CacheHit<No 
|| CacheHit>Unknown) 
PrintEnumBoundaryError ("CacheHit",CacheHit,No,Unknown); 


( CacheBusy<No 
|] CacheBusy>Yes) 
PrintEnumBoundaryError ("CacheBusy", CacheBusy, No, ves); 


( Request<None 
|| Request>NumberOfRequestsAvailable) 
PrintEnumBoundaryError ("Request", Request, 

None, NumberOfRequestsAvailable) ; 


( LastRequest<None 
|| LastRequest>NumberOfRequestsAvailable) 
PrintEnumBoundaryError ("LastRequest ", Request, 

None, NumberOfRequestsAvailable) ; 








CA xk Xx k + x *k *x dk * kk kk kk + k x+ xk kx *x *x xk kx kx xk xk k x x x xk «x «x x+ x x x+ xk xk x Xx x k x x X X x x x x+ x X X X x X x+ x xX x x x x x+ xX x X X k+ XY *x * * 
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i Checking.c d + 
k * + 
t CheckingForValuesOutOfBounds XM 
e continued x * 


r Ké: 


BE e e e e de e e e de de dee de eode e e ee ee e e e ehe e ee ee ee ee de ee ee ede e e e he dece e ee ee he e e e de e e e e ede e * e ee e e x / 


me RequestSize<0 
f || RequestSize>BlockSize) 
ë me o zeBoundaryError ("ReguestSize“, RequestSize, 0, BlockSize); 


if ( RequestBlockNumber<0 
|| RequestBlockNumber>=NumberOfBlocks) 
{ 
PrintSizeBoundaryError ("RequestBlockNumber",RequestBlockNumber, 
0, NumberOfBlocks); 


) 


if ( TimeOfNextRequest<0 
|| TimeOfNextRequest»MaxTime) 
PrauntTimeBoundaryError ("TimeOfNextRequest",TimeOfNextRequest, 
01, MaxTime) ; 





"| for (SetIndex=0; Set Index<NumberOfSets; SetIndex++) 
if ( CacheNextBlock[SetIndex]<0 
|| CacheNextBlock [Set Index]>=NumberOfBlocks) 
PrintSizeBoundaryError ("CacheNextBlock", CacheNextBlock [Set Index], 
0, NumberOfBlocks); 


for (BlockIndex=0; BlockIndex<NumberOfBlocks; BlockIndex++) 
( 
for (SubBlockIndex=0; SubBlockIndex<NumberOfSubBlocks; SubBlockIndex++) 
{ 
if ( CacheValidBit [BlockIndex)] [SubBlockIndex] <0 
|| CacheValidBit [BlockIndex] [SubBlockIndex]}>1) 
PrintEnumBoundaryError ("CacheValidBit", 
CacheValidBit [BlockIndex] [SubBlockIndex], 
07 1) 


if ( CacheDirtyBit [BlockIndex]} [SubBlockIndex]<0 
|| CacheDirtyBit [BlockIndex] [SubBlockIndex]>1) 
Em EnumnBoundaryError ("CacheDirtyBit", 
CacheDirtyBit [BlockIndex] [SubBlockIndex), 
0,1); 


) 


for (Request Index=0; Request Index<Number0OfRequestsAvailable; Request Index++) 
if ( TotalRequest Time [Request Index] <0 
|| TotalRequest Time [Request Index] >Time) 
PrintTimeBoundaryError ("TotalRequestTime", 
TotalRequestTime [RequestIndex], 
01, Time); 


foo eee ÃO O T T 


* * 


de de 


** 


* * 


x* 


** 
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CheckingForValuesOutOfBounds 
continued 


* * 


de de 


de de 


de de 


* * 


** 


dece de de H H % e e ee AA aa WA WA AA 


for (StallIndex=0; 
StallIndex«NumberOfCacheWaitingForsAvailable; 
StallIndex++) 
if ( TotalStallTime [StallIndex] <0 
|| TotalStallTime[StallIndex]>Time) 
PrintTimeBoundaryError("TotalStallTime", 
TotalStallTime[StallIndex], 
01,Time); 


if ( TotalNumberOfAccesses<0 
|| TotalNumberOfAccesses»MaxScore) 
PrintScoreBoundaryError ("TotalNumberOfAccesses",TotalNumberOfAccesses, 
01, MaxScore); 


if ( TOA<O 
|| TOA»MaxTime) 
PrintTimeBoundaryError("TOA", TOA, 01, MaxTime); 


if ( TO 
|| TOD>MaxTime) 
PrintTimeBoundaryError("TOD", TOD, Ol, MaxTime); 





Le fe e oe eoe oe ole oe ode oe oe oe oe oe oe oe oe oe oe ode oe oe oe oe oe oe oe oe oe oe oe oe oe oe oe oie oe oe oe oie oie oe oie oe e oe oe oc oie oie oie oe oe oe oie X + + k+ X k+ k k k X k+ X kK h + + k k k k 
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* * 

PrintTimeBoundaryError * * 
*x dr 


NEES E rer erer ree eie ie e ee oe dece dede de dece dece dede yn e / 


lid PrintTimeBoundaryError(VariableName, Value, LowLimit, HighLimit) 





char *VariableName; 
TimeType Value; 

TimeType LowLimit; 
TimeType HighLimit; 


| 


{ 


PEN \N\MNError found in [CheckingForValuestOutOfBounds]"); 
Penice An$s is out of prescribed bounds.",VariableName); 


géant f ("\n\n IAS WAS n 290 
Eur c:trIimme(Value); 


parènt f (" An Below limit waS ........- 
PrintTime (LowLimit); 


Emupmtf(" An Mea LIME WASH. oo... > "O 
PrintTime (HighLimit); 


meant ("\n\n") ; 
DiscrepancyFound=Yes; 


} 


1 Eee e nece e ee de e O EEGENEN 


x + Page. 13-16 25 
** Checkingua ** 
** de dr 
X X PrintScoreBoundaryError ** 
* * f * ok 


3 Kk kk e de e ke de e ke he e ke e K e e e ke e e de de de e Ok kh kk de kc ke e de de e ke kde de e kk Ke de e de de Ke de K K de de e de e e e d e e de de % de d e e e / 


void PrintScoreBoundaryError (VariableName, Value, LowLimit, HighLimit) 
char *VariableName; 
ScoreType Value; 


ScoreType LowLimit; 
ScoreType HighLimit; 


{ 


printf("\n\nError found in [CheckingForValuestOutOfBounds])"); 
printf(" 4n$s is out of prescribed bounds.",VariableName); 


printf (nm The Valvelvas a Sai E 
PrintScoreCentered (Value); 


print Eta n The low limit was ......... "ys 
PrintScoreCentered(LowLimit); 


print MEM n The high Limitsvas a 1); 
PrintScoreCentered (HighLimit); 


printf (ainda 
DiscrepancyFound=Yes; 


) 





d + + + + +k k A+ k kk kk k kk k k k k k k K k k kr k x x x x x X k X kK k k + +k k kK k k K k k k + A 
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* * 


PrintSizeBoundaryError *% 


dd 





r 


a 


bid PrintSizeBoundaryError (VariableName, Value, LowLimit, HighLimit) 


char *VariableName; 
SizeType Value; 
SizeType LowLimit; 
| SizeType HighLimit; 
Í 


den in \NnError found in [CheckingForValuestOutOfBounds]"); 
Meme \n%s is out of prescribed bounds.",VariableName); 


Rn E ("Ann The value was ............. "); 
PrintSize (Value); 


pen ce An Che low Limit cus + 1); 
Frianeoize(LowLimit); 


EEXDER(" Wn me high irmsbgwass.. o... "Ja 
PrintSize(HighLimit); 


san nin"); 
DiscrepancyFound-Yes; 


) 


f Ce d de "de de de E O E E ÃO AA DUH 1 12 


* * Page 13=18 74 
* * Checking.c * * 
* * * * 
* * PrintEnumBoundaryError * * 
A r * Xx 


t t eo rr dda e a AA AA ZZ 


void PrintEnumBoundaryError(VariableName, Value, LowLimit, HighLimit) 
char *VariableName; 
int Value; 
int LowLimit; 
int Highline 
{ 


printf("\n\nError found in [CheckungkorValuestOUutO£fBounds] "5e 
printf(" \n%s is out of prescribed bounds.", VariableName) ; 


Print (nda The value Was. E 
printf (“Cdr male); 


printer (a T The low v1 GE 
Pprintt(" Loba 


printf (~An The high WA mwa Si e E "); 
printf ("zdar HighN imit, 


print UWA 
DiscrepancyFound=Yes; 


) 









| 


| 


Checkaing#e 


CheckingForInconsistencies () 


hid CheckingForInconsistencies () 


{ 


CacheWaitingForType CacheWaitingForIndex; 


ReguestType RequestIndex; 
TimeType TotalTime; 
ScoreType SumOfAccesses; 


HistogramIndexType HistogramIndex; 
5cOBeType PredictedNumberOfWordsReadFromMemory; 


TotalTime=0; 
for (CacheWaitingForIndex=Nothing; 
CacheWaitingForIndex«NumberOfCacheWaitingForsAvailable; 
CacheWaitingForindex++) 
TotalTime+=TotalStallTime[CacheWaitingForIndex]; 


if (TotalTime!-Time) 
PrintTotalTimeError (Time, TotalTime, "Stalls"); 
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+ + 


* * 


* * 


+ + 


* * 


l O e a a 3< de te dc dede: de de de de de de 3% de de d de de de de de de de d de d d de d % $ / 


| ek ee dece de He de k k aaa TTT 


* X 


* oc 


* * 


* * 


* * 
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CheckingForInconsistencies() 


kk 


** 


* * 


* * 


* x 


kk kk e e KK KKK KEE EEN 


TotalTime=0; 


for (RequestIndex=Nothing; 


if 


RequestIndex«NumberOfRequestsAvailable; 
Request Indextt) 
TotalTime+=TotalRequest Time [Request Index]; 


(TotalTime!=Time) 
PrintTotalTimeError (Time, TotalTime, "Requests"); 


for (Request Index=Read; 


LE 


RequestIndex«NumberOfRequestsAvailable; 
Request Index++) 
{ 


SumofAccesses = 0; 


for (HistogramIndex=0; 
HistogramIndex<FileHistogramMaxIndex; 
HistogramIndex++) 
SumOfAccesses+=RequestTimeHistogram[Request Index] [HistogramIndex]; 


if (SumOfAccesses!=NumberOfAccesses [Request Index]) 
PrintTotalScoreError (NumberOfAccesses [Request Index], 
SumOfAccesses, 
RequestString (Request Index]); 


) 


(CacheWaitingFor--Nothing && ReadBuffer.Empty==Yes 46 
UpdateReadBuffer--No && SearchBlockBuffer--zNo && 
RemoveReadDuplicates--Yes && WriteMissPolicy--WriteAround ) 
{ 
PredictedNumberOfWordsReadFromMemory= 
(NumberOfAccesses [Read] 
-NumberOfCacheHits [Read] 
-NumberOfBufferHits [Read] ) *BlockSize/WordSize; 
if (PredictedNumberOfWordsReadFromMemory!- 
TotalNumberOfWordsReadFromMemory) 
PrintTotalScoreError (PredictedNumberOfWordsReadFromMemory, 
TotalNumberOfWordsReadFromMemory, 
"Read Misses"); 





ai? 


o.. c -.............. 
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de de 

PrintTotalTimeError X X 
de de 


| 
Ee a H à x # % Kk / 





iid PrintTotalTimeError (TimeValue, TotalTimeValue, VariableName) 


TimeType TimeValue; 
TimeType TotalTimeValue; 
char *VariableName; 


4 


| 
| 
' 
| 


( 


| pm minError found in [CheckingForInconsistencies] the total sum"); 
| printf(" \nof $s times does not equal the actual time.", VariableName); 


panet ("\n\n Total time was equal to ... "); 
PrintTime (TimeValue); 

SERGE An The sumation of $s", VariableName); 
EISE An times Was . Ww....... Ww. "Ja 


PrintTime (TotalTimeValue); 
petri in Win"); 
DiscrepancyFound=Yes; 


) 


f Che he k k de kok oo e de de hehe kc he dc A RA NS UA 


** 


ko 


* $ 


de x 


de À 
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PrintTotalScoreError 


* de 


** 


*ok 


* ok 


** 


e k jek e e ko k de he de e ee e de k e e ee H MIE e e Ae AAA A E A ii 


void PrintTotalScoreError(TotalScoreValue, SumScoreValue, VariableName) 


ScoreType TotalScoreValue; 
ScoreType SumScoreValue; 
char *VariableName; 


{ 


printf("\n\nError found in [CheckingForInconsistencies] the total for"); 


printf(" \n%s does not equal the summation.", VariableName); 


print ie nn Total number of %s accesses", VariableName); 

Print haa a was GEHT EE D 
PrintScoreCentered(TotalScoreValue); 

prins The sumation of %s request histogram", VariableName); 
PEINE É ("HR was equal tow n E 


PrintScoreCentered(SumScoreValue); 
printf ("in 0, 
DiscrepancyFound=Yes; 


) 





qn 


t 
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CheckingPredictions > 


** 





EXOK Rk X k k X k k« kk kk kk kkxxx kk k kkk *k«***kx*xH#*x Hx *k*k*Ëà kx kX x # k k x # k x k x à / 


id CheckingPredictions() 


( 


| if (PredictedNumberOfAccesses [Read] !=NumberOfAccesses [Read] ) 


PrintScorePredictionError (PredictedNumber0OfAccesses [Read], 
NumberOfAccesses [Read], 
"Read Accesses"); 


if (PredictedNumberOfAccesses [Write] !=NumberOfAccesses [Write] ) 


PrintScorePredictionError (PredictedNumberOfAccesses [Write], 
NumberOfAccesses [Write], 
"Write Accesses"); 
if (DiscrepancyFound==No) 
( 
if (PredictedNumberOfHits [Read] != NumberOfCacheHits [Read] 
+ NumberOfBufferHits[Read] && 
BlockReplacementPolicy==LRU && 
SearchBlockBuffer--Yes && RemoveReadDuplicates--Yes) 


PrintScorePredictionError (PredictedNumberOfHits [Read], 
NumberOfCacheHits [Read] 
+NumberOfBufferHits [Read], 
"Read Hits"); 


if (PredictedNumberOfHits[Write] !- NumberOfCacheHits [Write] 
* NumberOfBufferHits(Write] && 
BlockReplacementPolicy==LRU ¿4 WriteMissPolicy==WriteAllocate && 
WritePolicy==WriteThrough) 


PrintScorePredictionError (PredictedNumberOfHits [Write], 
NumberOfCacheHits [Write] 
-NumberOfBufferHits [Write], 
"Write Hits"); 


f Code ce ee e e de dc e de Ade de de de de de ke kkk ke kee ee ee ke e E E 


* * Page 13-24 ** 
** Checking.c wa 
zk de * 
* * PrintPredictionError XX 
de ge * * 


> 


x e de de de de de de x x kx x x x x x x Xx x x A a cde A A x x x x x x x x x x x x x x kx x x x x x x x x x x x x x x x x x x x x A A AA A A e e A *x *x *« `** / 


void PrintScorePredictionError (PredictedValue, ActualValue, VariableName) 


ScoreType PredictedValme; 
ScoreType ActualValue; 
char *VariableName; 


d 

printf("ininError found in [CheckingPredictions] when trying to predict às”; 
VariableName) ; 

peintf(TAnAn The predicted value was ... "); 

PrintScoreCentered (PredictedValue) ; 


print Fides: D The actuate was soe nO 
PrintScoreCentered (Actual atea 


Pře) 
DiscrepancyFound=Yes; 


) 








dede *x *x *x *x x x x x x *%x *x Kk k *x *x *x x *x x x *x ode oc ode kx *%x oe ode ode oe oe oie *x x Xx x eode oe oe oe sie oie oie ie oie oe oie oe x x *x x X *x fe ie *x *x x *x x *x x *x *x *x he 3% *x *x *x *x * 
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Checking.c * * 

Xx 

PrintTimePredictionError * * 
*X * 


Eeer ke PELA LA A e k k x k k kx k k k k k k k k dee ee de de k e # x kx e e de k k k x x k kx x k kx x k k e de x dede ee / 





id PrintTimePredictionError (PredictedValue, 
| ActualValue, 
ReguestName, 
ProcedureName) 


TimeType PredictedValue; 
TimeType ActualValue; 


char *ReguestName; 
char *ProcedureName; 


pu niError found in [$s] when trying to predict time to complete Sen, 
ProcedureName, ReguestName); 


prints ("\n\n The predicted value was ... "); 
PrintScoreCentered (PredictedValue) ; 


perimet” An The actual value was ...... "); 
PrintScoreCentered (ActualValue); 


pesnde(\n\n"}); 
DiscrepancyFound=Yes; 


) 
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